From 814c21ed7d0e94d459778b32db8be1fe7eb85ba5 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:15:49 -0400
Subject: [PATCH 1/7] Update CDP Mode

---
 seleniumbase/core/sb_cdp.py                   | 55 ++++-------
 seleniumbase/undetected/cdp_driver/browser.py | 37 ++++---
 .../undetected/cdp_driver/cdp_util.py         | 66 ++++++-------
 seleniumbase/undetected/cdp_driver/config.py  | 24 ++---
 .../undetected/cdp_driver/connection.py       | 35 +++----
 seleniumbase/undetected/cdp_driver/element.py | 96 ++++++++++++-------
 seleniumbase/undetected/cdp_driver/tab.py     | 70 +++++++-------
 7 files changed, 191 insertions(+), 192 deletions(-)

diff --git a/seleniumbase/core/sb_cdp.py b/seleniumbase/core/sb_cdp.py
index 713809a0cc8..d71aa2b1786 100644
--- a/seleniumbase/core/sb_cdp.py
+++ b/seleniumbase/core/sb_cdp.py
@@ -116,7 +116,9 @@ def __add_sync_methods(self, element):
         element.send_file = (
             lambda *file_paths: self.__send_file(element, *file_paths)
         )
-        element.send_keys = lambda text: self.__send_keys(element, text)
+        element.send_keys = lambda text, **kwargs: self.__send_keys(
+            element, text, **kwargs
+        )
         element.set_text = lambda value: self.__set_text(element, value)
         element.set_value = lambda value: self.__set_value(element, value)
         element.type = lambda text: self.__type(element, text)
@@ -721,9 +723,11 @@ def __send_file(self, element, *file_paths):
             self.loop.run_until_complete(element.send_file_async(*file_paths))
         )
 
-    def __send_keys(self, element, text):
+    def __send_keys(self, element, text, **kwargs):
         return (
-            self.loop.run_until_complete(element.send_keys_async(text))
+            self.loop.run_until_complete(
+                element.send_keys_async(text, **kwargs)
+            )
         )
 
     def __set_text(self, element, value):
@@ -1270,26 +1274,7 @@ def press_keys(self, selector, text, timeout=None):
         self.__slow_mode_pause_if_set()
         element = self.select(selector, timeout=timeout)
         element.scroll_into_view()
-        submit = False
-        if text.endswith("\n") or text.endswith("\r"):
-            submit = True
-            text = text[:-1]
-        elif (
-            element.tag_name == "textarea"
-            and "\n" in text
-            and "\r" not in text
-        ):
-            text = text.replace("\n", "\r")
-        for key in text:
-            try:
-                element.send_keys(key)
-            except AttributeError:
-                element = self.select(selector, timeout=0.1)
-                element.send_keys(key)
-            time.sleep(float(0.0422 + (random.random() / 112.0)))
-        if submit:
-            element.send_keys("\r\n")
-            time.sleep(0.044)
+        element.send_keys(text, add_delay=True)
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.sleep(0.025))
 
@@ -1367,18 +1352,18 @@ def set_value(self, selector, text, timeout=None):
         self.loop.run_until_complete(self.page.sleep(0.025))
 
     def submit(self, selector):
-        submit_script = (
-            """elm = document.querySelector('%s');
-            const event = new KeyboardEvent("keydown", {
-                key: "Enter",
-                keyCode: 13,
-                code: "Enter",
-                which: 13,
-                bubbles: true
-            });
-            elm.dispatchEvent(event);""" % selector
-        )
-        self.loop.run_until_complete(self.page.evaluate(submit_script))
+        element = self.find_element(selector, timeout=1)
+        try:
+            element.press_keys("\n")
+        except Exception:
+            submit_script = (
+                """
+                const el = document.querySelector('%s');
+                const form = el.form ?? el.closest('form');
+                form.requestSubmit();
+                """ % selector
+            )
+            self.loop.run_until_complete(self.page.evaluate(submit_script))
 
     def evaluate(self, expression):
         """Run a JavaScript expression and return the result."""
diff --git a/seleniumbase/undetected/cdp_driver/browser.py b/seleniumbase/undetected/cdp_driver/browser.py
index 2c72cb65856..384b2a626d4 100644
--- a/seleniumbase/undetected/cdp_driver/browser.py
+++ b/seleniumbase/undetected/cdp_driver/browser.py
@@ -22,7 +22,6 @@
 from seleniumbase import config as sb_config
 from seleniumbase.fixtures import constants
 from seleniumbase.fixtures import shared_utils
-from typing import List, Optional, Set, Tuple, Union
 import mycdp as cdp
 from . import cdp_util as util
 from . import tab
@@ -116,7 +115,7 @@ async def create(
         incognito: bool = False,
         guest: bool = False,
         browser_executable_path: PathLike = None,
-        browser_args: List[str] = None,
+        browser_args: list[str] = None,
         sandbox: bool = True,
         host: str = None,
         port: int = None,
@@ -160,7 +159,7 @@ def __init__(self, config: Config, **kwargs):
                 )
             )
         self.config = config
-        self.targets: List = []
+        self.targets: list = []
         self.info = None
         self._target = None
         self._process = None
@@ -182,7 +181,7 @@ def main_tab(self) -> tab.Tab:
         )[0]
 
     @property
-    def tabs(self) -> List[tab.Tab]:
+    def tabs(self) -> list[tab.Tab]:
         """Returns the current targets which are of type "page"."""
         tabs = filter(lambda item: item.type_ == "page", self.targets)
         return list(tabs)
@@ -199,7 +198,7 @@ def stopped(self):
             return False
         return True
 
-    async def wait(self, time: Union[float, int] = 1) -> Browser:
+    async def wait(self, time: float | int = 1) -> Browser:
         """Wait for <time> seconds. Important to use,
         especially in between page navigation.
         :param time:
@@ -210,12 +209,12 @@ async def wait(self, time: Union[float, int] = 1) -> Browser:
     """Alias for wait"""
     async def _handle_target_update(
         self,
-        event: Union[
-            cdp.target.TargetInfoChanged,
-            cdp.target.TargetDestroyed,
-            cdp.target.TargetCreated,
-            cdp.target.TargetCrashed,
-        ],
+        event: (
+            cdp.target.TargetInfoChanged
+            | cdp.target.TargetDestroyed
+            | cdp.target.TargetCreated
+            | cdp.target.TargetCrashed
+        ),
     ):
         """This is an internal handler which updates the targets
         when Chrome emits the corresponding event."""
@@ -735,8 +734,8 @@ async def start(self=None) -> Browser:
 
     async def grant_permissions(
         self,
-        permissions: List[str] | str,
-        origin: Optional[str] = None,
+        permissions: list[str] | str,
+        origin: str | None = None,
     ):
         """Grant specific permissions to the current window.
         Applies to all origins if no origin is specified."""
@@ -863,14 +862,14 @@ async def tile_windows(self, windows=None, max_columns: int = 0):
                     continue
         return grid
 
-    async def _get_targets(self) -> List[cdp.target.TargetInfo]:
+    async def _get_targets(self) -> list[cdp.target.TargetInfo]:
         info = await self.connection.send(
             cdp.target.get_targets(), _is_update=True
         )
         return info
 
     async def update_targets(self):
-        targets: List[cdp.target.TargetInfo]
+        targets: list[cdp.target.TargetInfo]
         targets = await self._get_targets()
         for t in targets:
             for existing_tab in self.targets:
@@ -1144,7 +1143,7 @@ def __del__(self):
         pass
 
 
-__registered__instances__: Set[Browser] = set()
+__registered__instances__: set[Browser] = set()
 
 
 class CookieJar:
@@ -1153,7 +1152,7 @@ def __init__(self, browser: Browser):
 
     async def get_all(
         self, requests_cookie_format: bool = False
-    ) -> List[Union[cdp.network.Cookie, "http.cookiejar.Cookie"]]:
+    ) -> list[cdp.network.Cookie | http.cookiejar.Cookie]:
         """
         Get all cookies.
         :param requests_cookie_format: when True,
@@ -1186,7 +1185,7 @@ async def get_all(
             ]
         return cookies
 
-    async def set_all(self, cookies: List[cdp.network.CookieParam]):
+    async def set_all(self, cookies: list[cdp.network.CookieParam]):
         """
         Set cookies.
         :param cookies: List of cookies
@@ -1301,7 +1300,7 @@ async def clear(self):
 
 
 class HTTPApi:
-    def __init__(self, addr: Tuple[str, int]):
+    def __init__(self, addr: tuple[str, int]):
         self.host, self.port = addr
         self.api = "http://%s:%d" % (self.host, self.port)
 
diff --git a/seleniumbase/undetected/cdp_driver/cdp_util.py b/seleniumbase/undetected/cdp_driver/cdp_util.py
index fad824e3c39..5bb015f4647 100644
--- a/seleniumbase/undetected/cdp_driver/cdp_util.py
+++ b/seleniumbase/undetected/cdp_driver/cdp_util.py
@@ -8,6 +8,7 @@
 import time
 import types
 import typing
+from collections.abc import Callable, Generator
 from contextlib import suppress
 from seleniumbase import config as sb_config
 from seleniumbase import extensions
@@ -17,7 +18,6 @@
 from seleniumbase.core import proxy_helper
 from seleniumbase.fixtures import constants
 from seleniumbase.fixtures import shared_utils
-from typing import Optional, List, Union, Callable
 from .element import Element
 from .browser import Browser
 from .browser import PathLike
@@ -286,33 +286,33 @@ def __add_chrome_proxy_extension(
 
 
 async def start(
-    config: Optional[Config] = None,
+    config: Config | None = None,
     *,
-    user_data_dir: Optional[PathLike] = None,
-    headless: Optional[bool] = None,
-    incognito: Optional[bool] = None,
-    guest: Optional[bool] = None,
-    browser_executable_path: Optional[PathLike] = None,
-    browser_args: Optional[List[str]] = None,
-    xvfb_metrics: Optional[List[str]] = None,  # "Width,Height" for Linux
-    ad_block: Optional[bool] = None,
-    sandbox: Optional[bool] = True,
-    lang: Optional[str] = None,  # Set the Language Locale Code
-    host: Optional[str] = None,  # Chrome remote-debugging-host
-    port: Optional[int] = None,  # Chrome remote-debugging-port
-    xvfb: Optional[int] = None,  # Use a special virtual display on Linux
-    headed: Optional[bool] = None,  # Override default Xvfb mode on Linux
-    expert: Optional[bool] = None,  # Open up closed Shadow-root elements
-    agent: Optional[str] = None,  # Set the user-agent string
-    proxy: Optional[str] = None,  # "host:port" or "user:pass@host:port"
-    tzone: Optional[str] = None,  # Eg "America/New_York", "Asia/Kolkata"
-    geoloc: Optional[list | tuple] = None,  # Eg (48.87645, 2.26340)
-    mobile: Optional[bool] = None,  # Use Mobile Mode with default args
-    disable_csp: Optional[str] = None,  # Disable content security policy
-    extension_dir: Optional[str] = None,  # Chrome extension directory
-    use_chromium: Optional[str] = None,  # Use the base Chromium browser
-    cft: Optional[str] = None,  # Use the Chrome-for-Testing browser
-    **kwargs: Optional[dict],
+    user_data_dir: PathLike | None = None,
+    headless: bool | None = None,
+    incognito: bool | None = None,
+    guest: bool | None = None,
+    browser_executable_path: PathLike | None = None,
+    browser_args: list[str] | None = None,
+    xvfb_metrics: list[str] | None = None,  # "Width,Height" for Linux
+    ad_block: bool | None = None,
+    sandbox: bool | None = True,
+    lang: str | None = None,  # Set the Language Locale Code
+    host: str | None = None,  # Chrome remote-debugging-host
+    port: int | None = None,  # Chrome remote-debugging-port
+    xvfb: int | None = None,  # Use a special virtual display on Linux
+    headed: bool | None = None,  # Override default Xvfb mode on Linux
+    expert: bool | None = None,  # Open up closed Shadow-root elements
+    agent: str | None = None,  # Set the user-agent string
+    proxy: str | None = None,  # "host:port" or "user:pass@host:port"
+    tzone: str | None = None,  # Eg "America/New_York", "Asia/Kolkata"
+    geoloc: list | tuple | None = None,  # Eg [48.87645, 2.26340]
+    mobile: bool | None = None,  # Use Mobile Mode with default args
+    disable_csp: str | None = None,  # Disable content security policy
+    extension_dir: str | None = None,  # Chrome extension directory
+    use_chromium: str | None = None,  # Use the base Chromium browser
+    cft: str | None = None,  # Use the Chrome-for-Testing browser
+    **kwargs: dict | None,
 ) -> Browser:
     """
     Helper function to launch a browser. It accepts several keyword parameters.
@@ -330,7 +330,7 @@ async def start(
     :type browser_executable_path: PathLike
     :param browser_args:
      ["--some-chromeparam=somevalue", "some-other-param=someval"]
-    :type browser_args: List[str]
+    :type browser_args: list[str]
     :param sandbox: Default True, but when set to False it adds --no-sandbox
      to the params, also when using linux under a root user,
      it adds False automatically (else Chrome won't start).
@@ -812,7 +812,7 @@ def free_port() -> int:
 
 def filter_recurse_all(
     doc: T, predicate: Callable[[cdp.dom.Node, Element], bool]
-) -> List[T]:
+) -> list[T]:
     """
     Test each child using predicate(child),
     and return all children for which predicate(child) == True
@@ -864,7 +864,7 @@ def filter_recurse(
 
 def circle(
     x, y=None, radius=10, num=10, dir=0
-) -> typing.Generator[typing.Tuple[float, float], None, None]:
+) -> Generator[tuple[float, float], None, None]:
     """
     A generator will calculate coordinates around a circle.
     :param x: start x position
@@ -910,7 +910,7 @@ def remove_from_tree(tree: cdp.dom.Node, node: cdp.dom.Node) -> cdp.dom.Node:
 
 
 async def html_from_tree(
-    tree: Union[cdp.dom.Node, Element], target: Tab
+    tree: cdp.dom.Node | Element, target: Tab
 ):
     if not hasattr(tree, "children"):
         raise TypeError("Object should have a .children attribute!")
@@ -931,7 +931,7 @@ async def html_from_tree(
 
 def compare_target_info(
     info1: cdp.target.TargetInfo, info2: cdp.target.TargetInfo
-) -> List[typing.Tuple[str, typing.Any, typing.Any]]:
+) -> list[tuple[str, typing.Any, typing.Any]]:
     """
     When logging mode is set to debug, browser object will log when target info
     is changed. To provide more meaningful log messages,
@@ -953,7 +953,7 @@ def loop():
     return loop
 
 
-def cdp_get_module(domain: Union[str, types.ModuleType]):
+def cdp_get_module(domain: str | types.ModuleType):
     """
     Get cdp module by given string.
     :param domain:
diff --git a/seleniumbase/undetected/cdp_driver/config.py b/seleniumbase/undetected/cdp_driver/config.py
index 80c7d8894f0..9546ee94d69 100644
--- a/seleniumbase/undetected/cdp_driver/config.py
+++ b/seleniumbase/undetected/cdp_driver/config.py
@@ -1,3 +1,4 @@
+from __future__ import annotations
 import json
 import logging
 import os
@@ -14,7 +15,6 @@
 from seleniumbase.drivers import chromium_drivers
 from seleniumbase.fixtures import constants
 from seleniumbase.fixtures import shared_utils
-from typing import Union, List, Optional
 
 __all__ = [
     "Config",
@@ -28,7 +28,7 @@
 logger = logging.getLogger(__name__)
 is_posix = sys.platform.startswith(("darwin", "cygwin", "linux"))
 
-PathLike = Union[str, pathlib.Path]
+PathLike = str | pathlib.Path
 AUTO = None
 IS_MAC = shared_utils.is_mac()
 IS_LINUX = shared_utils.is_linux()
@@ -42,19 +42,19 @@ class Config:
 
     def __init__(
         self,
-        user_data_dir: Optional[PathLike] = AUTO,
-        headless: Optional[bool] = False,
-        incognito: Optional[bool] = False,
-        guest: Optional[bool] = False,
-        browser_executable_path: Optional[PathLike] = AUTO,
-        browser_args: Optional[List[str]] = AUTO,
-        sandbox: Optional[bool] = True,
-        lang: Optional[str] = "en-US",
+        user_data_dir: PathLike | None = AUTO,
+        headless: bool | None = False,
+        incognito: bool | None = False,
+        guest: bool | None = False,
+        browser_executable_path: PathLike | None = AUTO,
+        browser_args: list[str] | None = AUTO,
+        sandbox: bool | None = True,
+        lang: str | None = "en-US",
         host: str = AUTO,
         port: int = AUTO,
         expert: bool = AUTO,
-        proxy: Optional[str] = None,
-        extension_dir: Optional[str] = None,
+        proxy: str | None = None,
+        extension_dir: str | None = None,
         **kwargs: dict,
     ):
         """
diff --git a/seleniumbase/undetected/cdp_driver/connection.py b/seleniumbase/undetected/cdp_driver/connection.py
index 6702c335fb9..b42a758b56c 100644
--- a/seleniumbase/undetected/cdp_driver/connection.py
+++ b/seleniumbase/undetected/cdp_driver/connection.py
@@ -9,19 +9,12 @@
 import sys
 import types
 import warnings
-from typing import (
-    Optional,
-    Generator,
-    Union,
-    Awaitable,
-    Callable,
-    Any,
-    TypeVar,
-)
 import websockets
 from websockets.protocol import State
 from seleniumbase.fixtures import constants
 from . import cdp_util as util
+from collections.abc import Awaitable, Callable, Generator
+from typing import Any, TypeVar
 import mycdp as cdp
 import mycdp.network
 import mycdp.page
@@ -34,7 +27,7 @@
 GLOBAL_DELAY = 0.005
 MAX_SIZE: int = 2**28
 PING_TIMEOUT: int = 1800  # 30 minutes
-TargetType = Union[cdp.target.TargetInfo, cdp.target.TargetID]
+TargetType = cdp.target.TargetInfo | cdp.target.TargetID
 logging.getLogger("asyncio").setLevel(logging.CRITICAL)
 logger = logging.getLogger("uc.connection")
 
@@ -200,8 +193,8 @@ def closed(self):
 
     def add_handler(
         self,
-        event_type_or_domain: Union[type, types.ModuleType],
-        handler: Union[Callable, Awaitable],
+        event_type_or_domain: type | types.ModuleType,
+        handler: Callable | Awaitable,
     ):
         """
         Add a handler for given event.
@@ -282,7 +275,7 @@ async def aclose(self):
                 "\n❌ Closed websocket connection to %s", self.websocket_url
             )
 
-    async def sleep(self, t: Union[int, float] = 0.25):
+    async def sleep(self, t: int | float = 0.25):
         await self.update_target()
         await asyncio.sleep(t)
 
@@ -297,7 +290,7 @@ def feed_cdp(self, cdp_obj):
         """
         asyncio.ensure_future(self.send(cdp_obj))
 
-    async def wait(self, t: Union[int, float] = None):
+    async def wait(self, t: int | float = None):
         """
         Waits until the event listener reports idle
         (no new events received in certain timespan).
@@ -348,20 +341,20 @@ async def set_downloads_folder(self, downloads_path):
             )
         )
 
-    async def set_locale(self, locale: Optional[str] = None):
+    async def set_locale(self, locale: str | None = None):
         """Sets the Language Locale code via set_user_agent_override."""
         await self.set_user_agent(user_agent="", accept_language=locale)
         await self.send(cdp.emulation.set_locale_override(locale))
 
-    async def set_timezone(self, timezone: Optional[str] = None):
+    async def set_timezone(self, timezone: str | None = None):
         """Sets the Timezone via set_timezone_override."""
         await self.send(cdp.emulation.set_timezone_override(timezone))
 
     async def set_user_agent(
         self,
-        user_agent: Optional[str] = "",
-        accept_language: Optional[str] = None,
-        platform: Optional[str] = None,  # navigator.platform
+        user_agent: str | None = "",
+        accept_language: str | None = None,
+        platform: str | None = None,  # navigator.platform
     ):
         """Sets the User Agent via set_user_agent_override."""
         if not user_agent:
@@ -372,7 +365,7 @@ async def set_user_agent(
             platform=platform,
         ))
 
-    async def set_geolocation(self, geolocation: Optional[tuple] = None):
+    async def set_geolocation(self, geolocation: tuple | None = None):
         """Sets the User Agent via set_geolocation_override."""
         await self.send(cdp.browser.set_permission(
             permission={"name": "geolocation"}, setting="granted"
@@ -560,7 +553,7 @@ def time_before_considered_idle(self):
         return self._time_before_considered_idle
 
     @time_before_considered_idle.setter
-    def time_before_considered_idle(self, seconds: Union[int, float]):
+    def time_before_considered_idle(self, seconds: int | float):
         self._time_before_considered_idle = seconds
 
     async def cancel(self):
diff --git a/seleniumbase/undetected/cdp_driver/element.py b/seleniumbase/undetected/cdp_driver/element.py
index 91e240ae7e4..d6cda619fe6 100644
--- a/seleniumbase/undetected/cdp_driver/element.py
+++ b/seleniumbase/undetected/cdp_driver/element.py
@@ -15,6 +15,7 @@
 import mycdp.overlay
 import mycdp.page
 import mycdp.runtime
+from seleniumbase import config as sb_config
 from seleniumbase.fixtures import shared_utils
 
 logger = logging.getLogger(__name__)
@@ -25,8 +26,8 @@
 
 def create(
     node: cdp.dom.Node,
-    tab: Tab, tree:
-    typing.Optional[cdp.dom.Node] = None
+    tab: Tab,
+    tree: cdp.dom.Node | None = None
 ):
     """
     Factory for Elements.
@@ -309,7 +310,7 @@ def attrs(self):
         return self._attrs
 
     @property
-    def parent(self) -> typing.Union[Element, None]:
+    def parent(self) -> Element | None:
         """Get the parent element (node) of current element (node)."""
         if not self.tree:
             raise RuntimeError(
@@ -324,7 +325,7 @@ def parent(self) -> typing.Union[Element, None]:
         return parent_element
 
     @property
-    def children(self) -> typing.Union[typing.List[Element], str]:
+    def children(self) -> list[Element] | str:
         """
         Returns the element's children.
         Those children also have a children property
@@ -436,7 +437,7 @@ async def apply(self, js_function, return_by_value=True):
         self._remote_object = await self._tab.send(
             cdp.dom.resolve_node(backend_node_id=self.backend_node_id)
         )
-        result: typing.Tuple[cdp.runtime.RemoteObject, typing.Any] = (
+        result: tuple[cdp.runtime.RemoteObject, typing.Any] = (
             await self._tab.send(
                 cdp.runtime.call_function_on(
                     js_function,
@@ -474,7 +475,10 @@ async def get_position_async(self, abs=False) -> Position:
                 )
             )
             if not quads:
-                raise Exception("Could not find position for %s " % self)
+                # return Position([0, 0, 0, 0, 0, 0, 0, 0])
+                raise Exception(
+                    "Could not find position for %s." % self.node_name
+                )
             pos = Position(quads[0])
             if abs:
                 scroll_y = (await self.tab.evaluate("window.scrollY"))
@@ -488,14 +492,14 @@ async def get_position_async(self, abs=False) -> Position:
             logger.debug(
                 "No content quads for %s. "
                 "Mostly caused by element which is not 'in plain sight'."
-                % self
+                % self.node_name
             )
 
     async def mouse_click_async(
         self,
         button: str = "left",
-        buttons: typing.Optional[int] = 1,
-        modifiers: typing.Optional[int] = 0,
+        buttons: int | None = 1,
+        modifiers: int | None = 0,
         timeframe: float = 0.0,
     ):
         """
@@ -580,12 +584,12 @@ async def mouse_click_async(
 
     async def mouse_click_with_offset_async(
         self,
-        x: typing.Union[float, int],
-        y: typing.Union[float, int],
+        x: float | int,
+        y: float | int,
         center: bool = False,
         button: str = "left",
-        buttons: typing.Optional[int] = 1,
-        modifiers: typing.Optional[int] = 0,
+        buttons: int | None = 1,
+        modifiers: int | None = 0,
     ):
         x_offset = int(x)
         y_offset = int(y)
@@ -682,7 +686,7 @@ async def mouse_move_async(self):
 
     async def mouse_drag_async(
         self,
-        destination: typing.Union[Element, typing.Tuple[int, int]],
+        destination: Element | tuple[int, int],
         relative: bool = False,
         steps: int = 1,
     ):
@@ -817,7 +821,7 @@ async def clear_input_async(self):
             logger.debug("Could not clear element field: %s", e)
         return
 
-    async def send_keys_async(self, text: str):
+    async def send_keys_async(self, text: str, add_delay: bool = False):
         """
         Send text to an input field, or any other html element.
         Hint: If you ever get stuck where using `~click()`
@@ -828,21 +832,39 @@ async def send_keys_async(self, text: str):
         """
         if self.tag_name.lower() == "textarea" and text.endswith("\r\n"):
             text = text[0:-1]
+        elif text.endswith("\r\n"):
+            text = text[0:-2] + "\n"
         await self.apply("(elem) => elem.focus()")
         if (
-            IS_LINUX
-            and not (
-                self.tag_name.lower() == "textarea"
-                and text.endswith("\r") or text.endswith("\n")
-            )
+            hasattr(sb_config, "_use_new_send_keys")
+            and sb_config._use_new_send_keys
         ):
-            [
-                await self._tab.send(
-                    cdp.input_.dispatch_key_event(type_="char", text=char)
-                )
-                for char in list(text)
-            ]
+            # Force the new send_keys method on Linux,
+            # which may need the old version for stealth.
+            # (Usage: sb_config._use_new_send_keys = True)
+            # **EXPERIMENTAL**
+            await self.__new_send_keys_async(text, add_delay)
             return
+        if IS_LINUX:
+            for char in text:
+                if not (
+                    self.tag_name.lower() == "textarea"
+                    and char.endswith("\r") or char.endswith("\n")
+                ):
+                    await self._tab.send(
+                        cdp.input_.dispatch_key_event(type_="char", text=char)
+                    )
+                    if add_delay:
+                        await asyncio.sleep(
+                            float(0.04 + (random.random() / 110.0))
+                        )
+                else:
+                    await self.__new_send_keys_async(char, add_delay)
+            return
+        await self.__new_send_keys_async(text, add_delay)
+
+    async def __new_send_keys_async(self, text: str, add_delay: bool = False):
+        """A helper method for send_keys_async()"""
         # Map non-alphanumeric symbols to the correct CDP virtual key code.
         # Prevents collisions with control keys. Eg. ord('.') = 46 = VK_DELETE.
         SYMBOL_MAP = {
@@ -942,6 +964,8 @@ async def send_keys_async(self, text: str):
                     windows_virtual_key_code=vk,
                 )
             )
+            if add_delay:
+                await asyncio.sleep(float(0.04 + (random.random() / 110.0)))
 
     async def send_file_async(self, *file_paths: PathLike):
         """
@@ -1061,9 +1085,9 @@ async def query_selector_async(self, selector: str):
 
     async def save_screenshot_async(
         self,
-        filename: typing.Optional[PathLike] = "auto",
-        format: typing.Optional[str] = "png",
-        scale: typing.Optional[typing.Union[int, float]] = 1,
+        filename: PathLike | None = "auto",
+        format: str | None = "png",
+        scale: int | float | None = 1,
     ):
         """
         Saves a screenshot of this element (only).
@@ -1138,10 +1162,10 @@ async def save_screenshot_async(
 
     async def flash_async(
         self,
-        duration: typing.Union[float, int] = 0.5,
-        color: typing.Optional[str] = "EE4488",
-        x_offset: typing.Union[float, int] = 0,
-        y_offset: typing.Union[float, int] = 0,
+        duration: float | int = 0.5,
+        color: str | None = "EE4488",
+        x_offset: float | int = 0,
+        y_offset: float | int = 0,
     ):
         """
         Displays for a short time a red dot on the element.
@@ -1250,9 +1274,9 @@ async def highlight_overlay_async(self):
 
     async def record_video_async(
         self,
-        filename: typing.Optional[str] = None,
-        folder: typing.Optional[str] = None,
-        duration: typing.Optional[typing.Union[int, float]] = None,
+        filename: str | None = None,
+        folder: str | None = None,
+        duration: int | float | None = None,
     ):
         """
         Experimental option.
diff --git a/seleniumbase/undetected/cdp_driver/tab.py b/seleniumbase/undetected/cdp_driver/tab.py
index ef9399930c3..9ecb93dada0 100644
--- a/seleniumbase/undetected/cdp_driver/tab.py
+++ b/seleniumbase/undetected/cdp_driver/tab.py
@@ -14,7 +14,6 @@
 from seleniumbase.fixtures import js_utils
 from seleniumbase.fixtures import page_utils
 from seleniumbase.fixtures import shared_utils
-from typing import Dict, List, Union, Optional, Tuple
 from . import browser as cdp_browser
 from . import element
 from . import cdp_util as util
@@ -129,13 +128,13 @@ class Tab(Connection):
     and contains all domains/actions/events you can act upon.
     """
     browser: cdp_browser.Browser
-    _download_behavior: List[str] = None
+    _download_behavior: list[str] = None
 
     def __init__(
         self,
         websocket_url: str,
         target: cdp.target.TargetInfo,
-        browser: Optional["cdp_browser.Browser"] = None,
+        browser: cdp_browser.Browser | None = None,
         **kwargs,
     ):
         super().__init__(websocket_url, target, browser, **kwargs)
@@ -180,7 +179,7 @@ async def find(
         text: str,
         best_match: bool = False,
         return_enclosing_element: bool = True,
-        timeout: Union[int, float] = 10,
+        timeout: int | float = 10,
     ):
         """
         Find single element by text.
@@ -236,7 +235,7 @@ async def find(
     async def select(
         self,
         selector: str,
-        timeout: Union[int, float] = 10,
+        timeout: int | float = 10,
     ) -> element.Element:
         """
         Find a single element by css selector.
@@ -253,8 +252,8 @@ async def select(
     async def find_all(
         self,
         text: str,
-        timeout: Union[int, float] = 10,
-    ) -> List[element.Element]:
+        timeout: int | float = 10,
+    ) -> list[element.Element]:
         """
         Find multiple elements by text.
         Can also be used to wait for such elements to appear.
@@ -286,9 +285,9 @@ async def find_all(
     async def select_all(
         self,
         selector: str,
-        timeout: Union[int, float] = 10,
+        timeout: int | float = 10,
         include_frames=False,
-    ) -> List[element.Element]:
+    ) -> list[element.Element]:
         """
         Find multiple elements by CSS Selector.
         Can also be used to wait for such elements to appear.
@@ -381,7 +380,7 @@ async def goto(self, url="about:blank"):
     async def query_selector_all(
         self,
         selector: str,
-        _node: Optional[Union[cdp.dom.Node, "element.Element"]] = None,
+        _node: cdp.dom.Node | element.Element | None = None,
     ):
         """
         Equivalent of JavaScript "document.querySelectorAll".
@@ -435,7 +434,7 @@ async def query_selector_all(
     async def query_selector(
         self,
         selector: str,
-        _node: Optional[Union[cdp.dom.Node, element.Element]] = None,
+        _node: cdp.dom.Node | element.Element | None = None,
     ):
         """
         Find a single element based on a CSS Selector string.
@@ -481,7 +480,7 @@ async def query_selector(
     async def find_elements_by_text(
         self,
         text: str,
-    ) -> List[element.Element]:
+    ) -> list[element.Element]:
         """
         Returns element which match the given text.
         Note: This may (or will) also return any other element
@@ -567,9 +566,9 @@ async def find_elements_by_text(
     async def find_element_by_text(
         self,
         text: str,
-        best_match: Optional[bool] = False,
-        return_enclosing_element: Optional[bool] = True,
-    ) -> Union[element.Element, None]:
+        best_match: bool | None = False,
+        return_enclosing_element: bool | None = True,
+    ) -> element.Element | None:
         """
         Finds and returns the first element containing <text>, or best match.
         :param text:
@@ -691,8 +690,8 @@ async def is_online(self):
 
     async def reload(
         self,
-        ignore_cache: Optional[bool] = False,
-        script_to_evaluate_on_load: Optional[str] = None,
+        ignore_cache: bool | None = False,
+        script_to_evaluate_on_load: str | None = None,
     ):
         """
         Reloads the page
@@ -731,11 +730,10 @@ async def evaluate(
         return None
 
     async def js_dumps(
-        self, obj_name: str, return_by_value: Optional[bool] = True
-    ) -> Union[
-        Dict,
-        Tuple[cdp.runtime.RemoteObject, cdp.runtime.ExceptionDetails],
-    ]:
+        self,
+        obj_name: str,
+        return_by_value: bool | None = True,
+    ) -> dict | tuple[cdp.runtime.RemoteObject, cdp.runtime.ExceptionDetails]:
         """
         Dump Given js object with its properties and values as a dict.
         Note: Complex objects might not be serializable,
@@ -906,7 +904,7 @@ async def close(self):
             await self.aclose()
             await asyncio.sleep(0.1)
 
-    async def get_window(self) -> Tuple[
+    async def get_window(self) -> tuple[
         cdp.browser.WindowID, cdp.browser.Bounds
     ]:
         """Get the window Bounds"""
@@ -1072,9 +1070,9 @@ async def scroll_up(self, amount=25):
 
     async def wait_for(
         self,
-        selector: Optional[str] = "",
-        text: Optional[str] = "",
-        timeout: Optional[Union[int, float]] = 10,
+        selector: str | None = "",
+        text: str | None = "",
+        timeout: int | float | None = 10,
     ) -> element.Element:
         """
         Variant on query_selector_all and find_elements_by_text.
@@ -1145,7 +1143,7 @@ async def internalize_links(self):
         await self.set_attributes('[target="_blank"]', "target", "_self")
 
     async def download_file(
-        self, url: str, filename: Optional[PathLike] = None
+        self, url: str, filename: PathLike | None = None
     ):
         """
         Downloads the file by the given url.
@@ -1190,9 +1188,9 @@ async def download_file(
 
     async def save_screenshot(
         self,
-        filename: Optional[PathLike] = "auto",
-        format: Optional[str] = "png",
-        full_page: Optional[bool] = False,
+        filename: PathLike | None = "auto",
+        format: str | None = "png",
+        full_page: bool | None = False,
     ) -> str:
         """
         Saves a screenshot of the page.
@@ -1247,7 +1245,7 @@ async def save_screenshot(
 
     async def print_to_pdf(
         self,
-        filename: Optional[PathLike] = "auto",
+        filename: PathLike | None = "auto",
     ) -> str:
         """
         Saves a webpage as a PDF.
@@ -1294,14 +1292,14 @@ async def set_download_path(self, path: PathLike):
         )
         self._download_behavior = ["allow", str(path.resolve())]
 
-    async def get_all_linked_sources(self) -> List["element.Element"]:
+    async def get_all_linked_sources(self) -> list["element.Element"]:
         """Get all elements of tag: link, a, img, scripts meta, video, audio"""
         all_assets = await self.query_selector_all(
             selector="a,link,img,script,meta"
         )
         return [element.create(asset, self) for asset in all_assets]
 
-    async def get_all_urls(self, absolute=True) -> List[str]:
+    async def get_all_urls(self, absolute=True) -> list[str]:
         """
         Convenience function, which returns all links (a,link,img,script,meta).
         :param absolute:
@@ -1915,9 +1913,9 @@ async def set_local_storage(self, items: dict):
 
     def __call__(
         self,
-        text: Optional[str] = "",
-        selector: Optional[str] = "",
-        timeout: Optional[Union[int, float]] = 10,
+        text: str | None = "",
+        selector: str | None = "",
+        timeout: int | float | None = 10,
     ):
         """
         Alias to query_selector_all or find_elements_by_text,

From a3f0b5715fdb2d42e8ca53a043c173555f0ce097 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:17:10 -0400
Subject: [PATCH 2/7] Improve output from driver downloads

---
 seleniumbase/console_scripts/sb_install.py | 55 ++++++++++------------
 1 file changed, 25 insertions(+), 30 deletions(-)

diff --git a/seleniumbase/console_scripts/sb_install.py b/seleniumbase/console_scripts/sb_install.py
index 30e297340d2..b9cefc4c4e0 100644
--- a/seleniumbase/console_scripts/sb_install.py
+++ b/seleniumbase/console_scripts/sb_install.py
@@ -659,8 +659,8 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             else:
                 not_latest = c5 + "(" + c4 + "Legacy Version" + c5 + ")" + cr
                 p_version = p_version + " " + not_latest
-            msg = c2 + "chromedriver to download" + cr
-            log_d("\n*** %s = %s" % (msg, p_version))
+            msg = c2 + "chromedriver" + cr
+            log_d("\n*** Getting %s %s" % (msg, p_version))
         else:
             raise Exception("Could not find chromedriver to download!\n")
         if not get_latest:
@@ -704,9 +704,9 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             use_version = found_version
         if not use_version:
             use_version = get_cft_latest_version_from_milestone(major_version)
-        msg = c2 + "Chrome for Testing to download" + cr
+        msg = c2 + "Chrome for Testing" + cr
         p_version = c3 + use_version + cr
-        log_d("\n*** %s = %s" % (msg, p_version))
+        log_d("\n*** Getting %s %s" % (msg, p_version))
         if IS_MAC:
             if IS_ARM_MAC:
                 platform_code = "mac-arm64"
@@ -813,9 +813,9 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             use_version = found_version
         if not use_version:
             use_version = get_cft_latest_version_from_milestone(major_version)
-        msg = c2 + "Chrome-Headless-Shell to download" + cr
+        msg = c2 + "Chrome-Headless-Shell" + cr
         p_version = c3 + use_version + cr
-        log_d("\n*** %s = %s" % (msg, p_version))
+        log_d("\n*** Getting %s %s" % (msg, p_version))
         if IS_MAC:
             if IS_ARM_MAC:
                 platform_code = "mac-arm64"
@@ -892,9 +892,9 @@ def main(override=None, intel_for_uc=None, force_uc=None):
         if not found_geckodriver:
             url_request = requests_get(download_url)
         if found_geckodriver or url_request.ok:
-            msg = c2 + "geckodriver to download" + cr
+            msg = c2 + "geckodriver" + cr
             p_version = c3 + use_version + cr
-            log_d("\n*** %s = %s" % (msg, p_version))
+            log_d("\n*** Getting %s %s" % (msg, p_version))
         else:
             raise Exception(
                 "\nCould not find the specified geckodriver "
@@ -999,9 +999,9 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 raise Exception(
                     "Could not find version [%s] of EdgeDriver!" % use_version
                 )
-        msg = c2 + "edgedriver to download" + cr
+        msg = c2 + "edgedriver" + cr
         p_version = c3 + use_version + cr
-        log_d("\n*** %s = %s" % (msg, p_version))
+        log_d("\n*** Getting %s %s" % (msg, p_version))
     elif name == "iedriver":
         full_version = "4.14.0"
         use_version = full_version
@@ -1029,9 +1029,9 @@ def main(override=None, intel_for_uc=None, force_uc=None):
         url_request = requests_get_with_retry(headless_ie_url)
         if url_request.ok:
             headless_ie_exists = True
-            msg = c2 + "HeadlessIEDriver to download" + cr
+            msg = c2 + "HeadlessIEDriver" + cr
             p_version = c3 + headless_ie_version + cr
-            log_d("\n*** %s = %s" % (msg, p_version))
+            log_d("\n*** Getting %s %s" % (msg, p_version))
     else:
         invalid_run_command()
 
@@ -1095,7 +1095,7 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                     os.remove(new_file)
         if not driver_file or not driver_path or not filename:
             raise Exception("headless_ie_selenium.exe missing from Zip file!")
-        log_d("Extracting %s from %s ..." % (filename, headless_ie_file_name))
+        log_d("Extracting %s from %s:" % (filename, headless_ie_file_name))
         zip_ref.extractall(downloads_folder)
         zip_ref.close()
         os.remove(zip_file_path)
@@ -1120,13 +1120,12 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             os.rmdir(os.path.join(downloads_folder, h_ie_fn))
         driver_path = os.path.join(downloads_folder, filename)
         log_d(
-            "The file [%s] was saved to:\n%s%s%s\n"
+            "['%s'] was saved to:\n%s%s%s\n"
             % (filename, c3, driver_path, cr)
         )
-        log_d("Making [%s %s] executable ..." % (driver_file, use_version))
         make_executable(driver_path)
         log_d(
-            "%s[%s %s] is now ready for use!%s"
+            "%s[%s %s] is ready for use!%s"
             % (c1, driver_file, use_version, cr)
         )
 
@@ -1180,7 +1179,7 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                         os.remove(new_file)  # Technically the old file now
             if driver_contents:
                 contents = driver_contents
-            log_d("Extracting %s from %s ..." % (contents, file_name))
+            log_d("Extracting %s from %s:" % (contents, file_name))
             if name == "uc_driver":
                 f_name = "uc_driver"
                 new_file = os.path.join(downloads_folder, f_name)
@@ -1232,11 +1231,10 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 d_folder = os.sep.join(pr_file.split(os.sep)[:-1]) + os.sep
                 d_file = pr_file.split(os.sep)[-1]
                 d_ff = c3 + d_folder + cr + "\n" + c3 + d_file + cr
-                log_d("The file [%s] was saved to:\n%s\n" % (f_name, d_ff))
-                log_d("Making [%s %s] executable ..." % (f_name, use_version))
+                log_d("['%s'] was saved to:\n%s\n" % (f_name, d_ff))
                 make_executable(new_file)
                 log_d(
-                    "%s[%s %s] is now ready for use!%s" %
+                    "%s[%s %s] is ready for use!%s" %
                     (c1, f_name, use_version, cr)
                 )
                 if copy_to_path and os.path.exists(LOCAL_PATH):
@@ -1301,7 +1299,7 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 if str_name == "IEDriverServer.exe":
                     raise Exception("IEDriverServer missing from Zip file!")
                 raise Exception("msedgedriver missing from Zip file!")
-            log_d("Extracting %s from %s ..." % (contents, file_name))
+            log_d("Extracting %s from %s:" % (contents, file_name))
             zip_ref.extractall(downloads_folder)
             zip_ref.close()
             os.remove(zip_file_path)
@@ -1323,13 +1321,12 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             pr_sep = c3 + os.sep + cr
             pr_driver_file = c3 + driver_file + cr
             log_d(
-                "The file [%s] was saved to:\n%s%s\n%s\n"
+                "['%s'] was saved to:\n%s%s\n%s\n"
                 % (driver_file, pr_driver_base, pr_sep, pr_driver_file)
             )
-            log_d("Making [%s %s] executable ..." % (driver_file, use_version))
             make_executable(driver_path)
             log_d(
-                "%s[%s %s] is now ready for use!%s"
+                "%s[%s %s] is ready for use!%s"
                 % (c1, driver_file, use_version, cr)
             )
             if copy_to_path and os.path.exists(LOCAL_PATH):
@@ -1462,7 +1459,7 @@ def main(override=None, intel_for_uc=None, force_uc=None):
                 if "Driver" in new_file or "driver" in new_file:
                     if os.path.exists(new_file):
                         os.remove(new_file)  # Technically the old file now
-            log_d("Extracting %s from %s ..." % (contents, file_name))
+            log_d("Extracting %s from %s:" % (contents, file_name))
             if sys.version_info < (3, 12):
                 tar.extractall(downloads_folder)
             else:
@@ -1473,11 +1470,10 @@ def main(override=None, intel_for_uc=None, force_uc=None):
             for f_name in contents:
                 new_file = os.path.join(downloads_folder, str(f_name))
                 pr_file = c3 + new_file + cr
-                log_d("The file [%s] was saved to:\n%s\n" % (f_name, pr_file))
-                log_d("Making [%s %s] executable ..." % (f_name, use_version))
+                log_d("['%s'] was saved to:\n%s\n" % (f_name, pr_file))
                 make_executable(new_file)
                 log_d(
-                    "%s[%s %s] is now ready for use!%s"
+                    "%s[%s %s] is ready for use!%s"
                     % (c1, f_name, use_version, cr)
                 )
                 if copy_to_path and os.path.exists(LOCAL_PATH):
@@ -1494,9 +1490,8 @@ def main(override=None, intel_for_uc=None, force_uc=None):
         # Not a .zip file or a .tar.gz file. Just a direct download.
         if "Driver" in file_name or "driver" in file_name:
             log_d("%sDownload Complete!%s\n" % (c1, cr))
-            log_d("Making [%s] executable ..." % file_name)
             make_executable(file_path)
-            log_d("%s[%s] is now ready for use!%s" % (c1, file_name, cr))
+            log_d("%s[%s] is ready for use!%s" % (c1, file_name, cr))
             log_d("Location of [%s]:\n%s\n" % (file_name, file_path))
 
 

From 17d723fb302ca7eb8a5604c05306a57688494499 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:18:24 -0400
Subject: [PATCH 3/7] Drop support for Python 3.9

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

diff --git a/setup.py b/setup.py
index f84a7639bfe..986adfe1e14 100755
--- a/setup.py
+++ b/setup.py
@@ -1,5 +1,5 @@
 """Setup steps for installing SeleniumBase dependencies and plugins.
-(Uses selenium 4.x and is compatible with Python 3.9+)"""
+(Uses selenium 4.x and is compatible with Python 3.10+)"""
 from setuptools import setup, find_packages  # noqa: F401
 import os
 import sys
@@ -136,7 +136,6 @@
         "Operating System :: POSIX :: Linux",
         "Programming Language :: Python",
         "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",

From 0b7cc37597bfdc1e008b6176a8cb793760da534a Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:19:43 -0400
Subject: [PATCH 4/7] Refresh Python dependencies

---
 mkdocs_build/requirements.txt |  4 +-
 requirements.txt              | 59 +++++++++---------------
 setup.py                      | 84 +++++++++++++----------------------
 3 files changed, 54 insertions(+), 93 deletions(-)

diff --git a/mkdocs_build/requirements.txt b/mkdocs_build/requirements.txt
index 5ab22ff43f3..861d06f2fb2 100644
--- a/mkdocs_build/requirements.txt
+++ b/mkdocs_build/requirements.txt
@@ -3,7 +3,7 @@
 
 regex>=2026.7.19
 pymdown-extensions>=10.21.3
-pipdeptree>=4.2.0
+pipdeptree>=4.2.1
 python-dateutil>=2.8.2
 click>=8.4.2
 Markdown==3.10.3
@@ -15,7 +15,7 @@ Babel==2.18.0
 paginate==0.5.7
 mkdocs==1.6.1
 mkdocs-material==9.6.23
-mkdocs-exclude-search==0.6.6
+mkdocs-exclude-search==0.6.7
 mkdocs-simple-hooks==0.1.5
 mkdocs-get-deps==0.2.2
 mkdocs-material-extensions==1.3.1
diff --git a/requirements.txt b/requirements.txt
index 2e0918d6085..59f9d2dd1dc 100755
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,22 +1,17 @@
-pip>=26.0.1;python_version<"3.10"
-pip>=26.2.1;python_version>="3.10"
+pip>=26.2.1
 packaging>=26.3
-setuptools~=70.2;python_version<"3.10"
-setuptools>=84.0.0;python_version>="3.10"
-wheel>=0.47.0
+setuptools>=84.0.0
+wheel>=0.48.0
 attrs>=26.1.0
 certifi>=2026.7.22
 exceptiongroup>=1.3.1
-websockets~=15.0.1;python_version<"3.10"
 websockets~=16.1.1;python_version=="3.10"
-websockets>=17.0.1;python_version>="3.11"
-filelock~=3.19.1;python_version<"3.10"
-filelock>=3.32.2;python_version>="3.10"
+websockets>=16.1.1;python_version>="3.11"
+filelock>=3.32.3
 fasteners>=0.20
 mycdp>=1.4.0
 pynose>=1.5.5
-platformdirs~=4.4.0;python_version<"3.10"
-platformdirs>=4.11.2;python_version>="3.10"
+platformdirs>=4.11.3
 typing-extensions>=4.16.0
 sbvirtualdisplay>=1.4.0
 MarkupSafe>=3.0.3
@@ -27,62 +22,50 @@ parse-type>=0.6.6
 colorama>=0.4.6
 psutil>=7.2.2
 pyyaml>=6.0.3
-pygments>=2.20.0
+pygments>=2.20.1
 pyreadline3>=3.5.4;platform_system=="Windows"
 tabcompleter>=1.4.1
 pdbp>=1.8.2
-idna>=3.18
-charset-normalizer>=3.4.9,<4
-urllib3>=1.26.20,<2;python_version<"3.10"
-urllib3>=2.7.0,<3;python_version>="3.10"
-requests~=2.32.5;python_version<"3.10"
-requests~=2.34.2;python_version>="3.10"
+idna>=3.19
+charset-normalizer>=3.5.1,<4
+urllib3>=2.7.0,<3
+requests~=2.34.2
 sniffio==1.3.1
 h11==0.16.0
 outcome==1.3.0.post0
-trio>=0.31.0,<1;python_version<"3.10"
-trio>=0.33.0,<1;python_version>="3.10"
+trio>=0.34.0,<1
 trio-websocket~=0.12.2
-wsproto==1.2.0;python_version<"3.10"
-wsproto~=1.3.2;python_version>="3.10"
+wsproto~=1.3.2
 websocket-client~=1.9.0
-selenium==4.32.0;python_version<"3.10"
-selenium==4.46.0;python_version>="3.10"
-cssselect==1.3.0;python_version<"3.10"
-cssselect>=1.5.0,<2;python_version>="3.10"
+selenium==4.47.0
+cssselect>=1.5.0,<2
 sortedcontainers==2.4.0
-execnet==2.1.1;python_version<"3.10"
-execnet==2.1.2;python_version>="3.10"
-iniconfig==2.1.0;python_version<"3.10"
-iniconfig==2.3.0;python_version>="3.10"
+execnet==2.1.2
+iniconfig==2.3.0
 pluggy==1.6.0
 pytest==8.4.2;python_version<"3.11"
 pytest==9.1.1;python_version>="3.11"
 pytest-html==4.0.2
 pytest-metadata==3.1.1
 pytest-ordering==0.6
-pytest-rerunfailures==16.0.1;python_version<"3.10"
 pytest-rerunfailures==16.3;python_version=="3.10"
-pytest-rerunfailures==16.4;python_version>="3.11"
+pytest-rerunfailures==16.6;python_version>="3.11"
 pytest-xdist==3.8.0
 parameterized==0.9.0
 behave==1.2.6
-soupsieve~=2.8.4;python_version<"3.10"
-soupsieve~=2.9.2;python_version>="3.10"
+soupsieve~=2.9.2
 beautifulsoup4~=4.15.0
 pyotp~=2.10.0
 python-xlib==0.33;platform_system=="Linux"
 PyAutoGUI>=0.9.54;platform_system=="Linux"
-markdown-it-py==3.0.0;python_version<"3.10"
-markdown-it-py==4.2.0;python_version>="3.10"
+markdown-it-py==4.2.0
 mdurl==0.1.2
 rich>=15.0.0,<16
 
 # --- Testing Requirements --- #
 # ("pip install -r requirements.txt" also installs this, but "pip install -e ." won't.)
 
-coverage>=7.10.7;python_version<"3.10"
-coverage>=7.15.4;python_version>="3.10"
+coverage>=7.15.4
 pytest-cov>=7.1.0
 flake8==7.3.0
 mccabe==0.7.0
diff --git a/setup.py b/setup.py
index 986adfe1e14..ec9211a9d49 100755
--- a/setup.py
+++ b/setup.py
@@ -159,27 +159,22 @@
         "Topic :: Software Development :: Testing :: Traffic Generation",
         "Topic :: Utilities",
     ],
-    python_requires=">=3.9",
+    python_requires=">=3.10",
     install_requires=[
-        'pip>=26.0.1;python_version<"3.10"',
-        'pip>=26.2.1;python_version>="3.10"',
+        'pip>=26.2.1',
         'packaging>=26.3',
-        'setuptools~=70.2;python_version<"3.10"',  # Newer ones had issues
-        'setuptools>=84.0.0;python_version>="3.10"',
-        'wheel>=0.47.0',
+        'setuptools>=84.0.0',
+        'wheel>=0.48.0',
         'attrs>=26.1.0',
         'certifi>=2026.7.22',
         'exceptiongroup>=1.3.1',
-        'websockets~=15.0.1;python_version<"3.10"',
         'websockets~=16.1.1;python_version=="3.10"',
-        'websockets>=17.0.1;python_version>="3.11"',
-        'filelock~=3.19.1;python_version<"3.10"',
-        'filelock>=3.32.2;python_version>="3.10"',
+        'websockets>=16.1.1;python_version>="3.11"',
+        'filelock>=3.32.3',
         'fasteners>=0.20',
         'mycdp>=1.4.0',
         'pynose>=1.5.5',
-        'platformdirs~=4.4.0;python_version<"3.10"',
-        'platformdirs>=4.11.2;python_version>="3.10"',
+        'platformdirs>=4.11.3',
         'typing-extensions>=4.16.0',
         'sbvirtualdisplay>=1.4.0',
         'MarkupSafe>=3.0.3',
@@ -190,54 +185,43 @@
         'colorama>=0.4.6',
         'psutil>=7.2.2',
         'pyyaml>=6.0.3',
-        'pygments>=2.20.0',
+        'pygments>=2.20.1',
         'pyreadline3>=3.5.4;platform_system=="Windows"',
         'tabcompleter>=1.4.1',
         'pdbp>=1.8.2',
-        'idna>=3.18',
-        'charset-normalizer>=3.4.9,<4',
-        'urllib3>=1.26.20,<2;python_version<"3.10"',
-        'urllib3>=2.7.0,<3;python_version>="3.10"',
-        'requests~=2.32.5;python_version<"3.10"',
-        'requests~=2.34.2;python_version>="3.10"',
+        'idna>=3.19',
+        'charset-normalizer>=3.5.1,<4',
+        'urllib3>=2.7.0,<3',
+        'requests~=2.34.2',
         'sniffio==1.3.1',
         'h11==0.16.0',
         'outcome==1.3.0.post0',
-        'trio>=0.31.0,<1;python_version<"3.10"',
-        'trio>=0.33.0,<1;python_version>="3.10"',
+        'trio>=0.34.0,<1',
         'trio-websocket~=0.12.2',
-        'wsproto==1.2.0;python_version<"3.10"',
-        'wsproto~=1.3.2;python_version>="3.10"',
+        'wsproto~=1.3.2',
         'websocket-client~=1.9.0',
-        'selenium==4.32.0;python_version<"3.10"',
-        'selenium==4.46.0;python_version>="3.10"',
-        'cssselect==1.3.0;python_version<"3.10"',
-        'cssselect>=1.5.0,<2;python_version>="3.10"',
+        'selenium==4.47.0',
+        'cssselect>=1.5.0,<2',
         'sortedcontainers==2.4.0',
-        'execnet==2.1.1;python_version<"3.10"',
-        'execnet==2.1.2;python_version>="3.10"',
-        'iniconfig==2.1.0;python_version<"3.10"',
-        'iniconfig==2.3.0;python_version>="3.10"',
+        'execnet==2.1.2',
+        'iniconfig==2.3.0',
         'pluggy==1.6.0',
         'pytest==8.4.2;python_version<"3.11"',
         'pytest==9.1.1;python_version>="3.11"',
         'pytest-html==4.0.2',  # Newer ones had issues
         'pytest-metadata==3.1.1',
         'pytest-ordering==0.6',
-        'pytest-rerunfailures==16.0.1;python_version<"3.10"',
         'pytest-rerunfailures==16.3;python_version=="3.10"',
-        'pytest-rerunfailures==16.4;python_version>="3.11"',
+        'pytest-rerunfailures==16.6;python_version>="3.11"',
         'pytest-xdist==3.8.0',
         'parameterized==0.9.0',
         'behave==1.2.6',  # Newer ones had issues
-        'soupsieve~=2.8.4;python_version<"3.10"',
-        'soupsieve~=2.9.2;python_version>="3.10"',
+        'soupsieve~=2.9.2',
         'beautifulsoup4~=4.15.0',
         'pyotp~=2.10.0',
         'python-xlib==0.33;platform_system=="Linux"',
         'PyAutoGUI>=0.9.54;platform_system=="Linux"',
-        'markdown-it-py==3.0.0;python_version<"3.10"',
-        'markdown-it-py==4.2.0;python_version>="3.10"',
+        'markdown-it-py==4.2.0',
         'mdurl==0.1.2',
         'rich>=15.0.0,<16',
     ],
@@ -253,15 +237,14 @@
         # pip install -e .[coverage]
         # Usage: coverage run -m pytest; coverage html; coverage report
         "coverage": [
-            'coverage>=7.10.7;python_version<"3.10"',
-            'coverage>=7.15.4;python_version>="3.10"',
+            'coverage>=7.15.4',
             'pytest-cov>=7.1.0',
         ],
         # pip install -e .[flake8]
         # Usage: flake8
         "flake8": [
             'flake8==7.3.0',
-            "mccabe==0.7.0",
+            'mccabe==0.7.0',
             'pyflakes==3.4.0',
             'pycodestyle==2.14.0',
         ],
@@ -273,19 +256,15 @@
         # pip install -e .[pdfminer]
         # (An optional library for parsing PDF files.)
         "pdfminer": [
-            'pdfminer.six==20251107;python_version<"3.10"',
-            'pdfminer.six==20260107;python_version>="3.10"',
+            'pdfminer.six==20260107',
             'cryptography==50.0.0',
-            'cffi==2.0.0;python_version<"3.10"',
-            'cffi==2.1.1;python_version>="3.10"',
-            'pycparser==2.23;python_version<"3.10"',
-            'pycparser==3.0;python_version>="3.10"',
+            'cffi==2.1.1',
+            'pycparser==3.0',
         ],
         # pip install -e .[pillow]
         # (An optional library for image-processing.)
         "pillow": [
-            'Pillow>=11.3.0;python_version<"3.10"',
-            'Pillow>=12.3.0;python_version>="3.10"',
+            'Pillow>=12.3.0',
         ],
         # pip install -e .[pip-system-certs]
         # (If you see [SSL: CERTIFICATE_VERIFY_FAILED], then get this.)
@@ -297,15 +276,14 @@
         # Usage: proxy
         # (That starts a proxy server on "127.0.0.1:8899".)
         "proxy": [
-            "proxy.py==2.4.3",  # 2.4.4 did not have "Listening on ..."
+            'proxy.py==2.4.3',  # 2.4.4 did not have "Listening on ..."
         ],
         # pip install -e .[playwright]
         # (For the Playwright integration.)
         "playwright": [
-            'playwright>=1.60.0;python_version<"3.10"',
-            'playwright>=1.62.0;python_version>="3.10"',
-            'greenlet>=3.2.5;python_version<"3.10"',
-            'greenlet>=3.5.4;python_version>="3.10"',
+            'playwright>=1.62.0',
+            'greenlet>=3.5.5',
+            'pyee>=13.0.1',
         ],
         # pip install -e .[pyautogui]
         # (Already a required dependency on Linux now.)

From 99327cc58df60a9cce7cd0e50588e806d65e90c3 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:20:08 -0400
Subject: [PATCH 5/7] Add scraping examples

---
 examples/cdp_mode/raw_cdp_quotes.py | 24 ++++++++++++++++
 examples/cdp_mode/raw_cdp_yelp.py   | 43 +++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+)
 create mode 100644 examples/cdp_mode/raw_cdp_quotes.py
 create mode 100644 examples/cdp_mode/raw_cdp_yelp.py

diff --git a/examples/cdp_mode/raw_cdp_quotes.py b/examples/cdp_mode/raw_cdp_quotes.py
new file mode 100644
index 00000000000..2c24c0a12c2
--- /dev/null
+++ b/examples/cdp_mode/raw_cdp_quotes.py
@@ -0,0 +1,24 @@
+import json
+from seleniumbase import sb_cdp
+
+sb = sb_cdp.Chrome()
+sb.goto("https://quotes.toscrape.com/")
+all_quotes = []
+while True:
+    quotes = sb.find_elements("div.quote")
+    for quote in quotes:
+        all_quotes.append(
+            {
+                "author": quote.query_selector("span small").text,
+                "text": quote.query_selector("span.text").text,
+            }
+        )
+    if sb.is_element_visible("li.next"):
+        sb.click("li.next")
+    else:
+        break
+file_path = "downloaded_files/quotes.json"
+with open(file_path, "w", encoding="utf-8") as outfile:
+    json.dump(all_quotes, outfile)
+print(f'Quotes saved to "{file_path}".')
+sb.quit()
diff --git a/examples/cdp_mode/raw_cdp_yelp.py b/examples/cdp_mode/raw_cdp_yelp.py
new file mode 100644
index 00000000000..77cfab1eb17
--- /dev/null
+++ b/examples/cdp_mode/raw_cdp_yelp.py
@@ -0,0 +1,43 @@
+import json
+from seleniumbase import sb_cdp
+
+sb = sb_cdp.Chrome()
+sb.goto("https://www.yelp.com/")
+sb.sleep(3)
+restaurants_menu = 'button[aria-label*="Restaurants"]'
+cafes = 'span:contains("Cafes")'
+sb.wait_for_element(restaurants_menu)
+sb.sleep(1)
+sb.hover_and_click(restaurants_menu, cafes)
+sb.sleep(3)
+all_cafes = []
+counter = 0
+max_pages = 3
+while True:
+    dtci = '[data-traffic-crawl-id="SearchResult%s"]'
+    cafes = sb.find_elements('[data-testid="serp-ia-card"]')
+    for cafe in cafes:
+        name = cafe.query_selector(dtci % "BizName")
+        rating = cafe.query_selector(dtci % "BizRating")
+        snippet = cafe.query_selector(dtci % "ReviewSnippet")
+        if name and rating and snippet:
+            all_cafes.append(
+                {
+                    "name": name.text,
+                    "rating": rating.text,
+                    "snippet": snippet.text,
+                }
+            )
+    counter += 1
+    if counter >= max_pages:
+        break
+    if sb.is_element_visible('span:contains("Next Page")'):
+        sb.click('span:contains("Next Page")')
+        sb.sleep(1)
+    else:
+        break
+file_path = "downloaded_files/cafes.json"
+with open(file_path, "w", encoding="utf-8") as outfile:
+    json.dump(all_cafes, outfile)
+print(f'Cafes saved to "{file_path}".')
+sb.quit()

From 44e9d8564ce6afd764941219916e464174badac3 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:20:23 -0400
Subject: [PATCH 6/7] Update the ReadMe

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

diff --git a/README.md b/README.md
index d8acaabc5ac..98ba074315a 100755
--- a/README.md
+++ b/README.md
@@ -11,6 +11,8 @@
 
 <p align="center" class="hero__title"><b>All-in-one Browser Automation Framework:<br />Web Crawling / Testing / Scraping / Stealth</b></p>
 
+<p align="center"><a href="https://trendshift.io/repositories/12493?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-12493" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/12493" alt="seleniumbase%2FSeleniumBase | Trendshift" width="250" height="55"/></a></p>
+
 <p align="center"><a href="https://pypi.python.org/pypi/seleniumbase" target="_blank"><img src="https://img.shields.io/pypi/v/seleniumbase.svg?color=3399EE" alt="PyPI version" /></a> <a href="https://pepy.tech/projects/seleniumbase?timeRange=threeMonths&category=version&includeCIDownloads=true&granularity=daily&viewType=line&versions=*" target="_blank"><img src="https://static.pepy.tech/badge/seleniumbase" alt="SeleniumBase PyPI downloads" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-22BBCC.svg" title="SeleniumBase" /></a> <a href="https://seleniumbase.io"><img src="https://img.shields.io/badge/docs-seleniumbase.io-11BBAA.svg" alt="SeleniumBase Docs" /></a> <a href="https://github.com/seleniumbase/SeleniumBase/actions" target="_blank"><img src="https://github.com/seleniumbase/SeleniumBase/workflows/Tests/badge.svg" alt="SeleniumBase GitHub Actions" /></a> <a href="https://www.youtube.com/playlist?list=PLp9uKicxkBc5UIlGi2BuE3aWC7JyXpD3m"><img src="https://img.shields.io/badge/docs-📺-F12345.svg?style=flat&logo=YouTube&logoColor=white&label=YouTube" alt="YouTube Channel" /></a></p>
 
 <p align="center">

From 0be0f562c918bef4c27ab19c5b3068a28aff8835 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Wed, 19 Aug 2026 00:20:40 -0400
Subject: [PATCH 7/7] Version 4.52.0

---
 seleniumbase/__version__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/seleniumbase/__version__.py b/seleniumbase/__version__.py
index 8997f2184ad..3d75d1477ff 100755
--- a/seleniumbase/__version__.py
+++ b/seleniumbase/__version__.py
@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.51.12"
+__version__ = "4.52.0"