seleniumbase 4.54.3__tar.gz → 4.54.5__tar.gz

{seleniumbase-4.54.3/seleniumbase.egg-info → seleniumbase-4.54.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.54.3
+Version: 4.54.5
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -126,7 +126,7 @@ Requires-Dist: allure-pytest>=2.16.0; extra == "allure"
 Requires-Dist: allure-python-commons>=2.16.0; extra == "allure"
 Requires-Dist: allure-behave>=2.16.0; extra == "allure"
 Provides-Extra: coverage
-Requires-Dist: coverage>=7.16.0; extra == "coverage"
+Requires-Dist: coverage>=7.16.1; extra == "coverage"
 Requires-Dist: pytest-cov>=7.1.0; extra == "coverage"
 Provides-Extra: flake8
 Requires-Dist: flake8==7.3.0; extra == "flake8"

{seleniumbase-4.54.3 → seleniumbase-4.54.5}/mcp_servers/server.py

@@ -34,14 +34,15 @@ having to choose between multiple near-identical tools.
 
 Tool-selection philosophy:
 - Use 'start_browser'/'close_browser' for opening/quitting the web browser.
-- Use 'goto_url'/'manage_history' for browser navigation and history
+- Use 'open_url'/'manage_history' for browser navigation and history
   inspection.
 - Use 'get_page_info' for reading browser/page metadata such as URL/title.
 - Use 'get_content'/'get_attributes' for reading text, HTML, or attributes.
 - Use 'find_elements' for discovering and inspecting multiple matching
   elements as structured data.
-- Use 'check_condition' for an immediate, non-waiting state check.
-- Use 'wait_for' when the agent needs to wait for a condition to become true.
+- Use 'check_if_condition' for an immediate, non-waiting state check.
+- Use 'wait_for_condition' when the agent needs to wait for a condition
+  to become true.
 - Use 'assert_condition' when the agent needs to verify an expected condition
   and treat failure as an assertion error.
 - Use 'click_element'/'type_text'/'select_option' for standard page
@@ -111,7 +112,7 @@ def start_browser(
 ) -> str:
     """Launch a persistent SeleniumBase Pure CDP Mode browser session.
 
-    Call this before using browser interaction tools such as goto_url,
+    Call this before using browser interaction tools such as open_url,
     get_content, click_element, type_text, or find_elements. The same browser
     session remains active across subsequent MCP tool calls until
     close_browser is called or the server process exits.
@@ -303,8 +304,8 @@ def get_page_info() -> dict[str, Any]:
         - Need URL, title, origin, or User-Agent -> use get_page_info.
         - Need visible page text or HTML -> use get_content.
         - Need information about matching elements -> use find_elements.
-        - Need an immediate state check -> use check_condition.
-        - Need to wait for a condition -> use wait_for.
+        - Need an immediate state check -> use check_if_condition.
+        - Need to wait for a condition -> use wait_for_condition.
         - Need to verify an expected condition -> use assert_condition.
 
     Unlike a dedicated browser-status tool, get_page_info is the single
@@ -338,8 +339,8 @@ def get_page_info() -> dict[str, Any]:
 
 @mcp.tool()
 @handle_sb_errors
-def goto_url(url: str) -> str:
-    """Navigate the current browser tab to a URL.
+def open_url(url: str) -> str:
+    """Navigate the current browser tab to the URL provided.
 
     Use this when the browser needs to visit a new URL rather than move
     through its existing back/forward history.
@@ -350,17 +351,18 @@ def goto_url(url: str) -> str:
 
     Navigation waits for the browser's navigation operation to complete
     before returning. Dynamic content may still be loading;
-    use wait_for when synchronization is required.
+    use wait_for_condition when synchronization is required.
+    If there's an error, that gets propagated through @handle_sb_errors.
 
     Args:
-        url: Destination URL. May be a complete URL such as
-            "https://example.com" or a hostname such as "example.com".
+        url: The destination URL. May be a complete URL such as
+            "https://example.com", or a hostname such as "example.com".
 
     Returns:
-        A confirmation message containing the requested URL.
+        A confirmation message containing the requested URL if successful.
 
     Tool selection:
-        - Go to a new URL -> use goto_url.
+        - Navigate to a new URL -> use open_url.
         - Return to the previous page -> use manage_history(action="back").
         - Go forward in history -> use manage_history(action="forward").
         - Refresh the current page -> use manage_history(action="reload").
@@ -379,7 +381,7 @@ def manage_history(
 
     Use 'back' or 'forward' for history navigation, 'reload' to refresh
     while bypassing the cache, or 'list' to inspect history.
-    Use 'goto_url' for navigation to an arbitrary URL.
+    Use 'open_url' for navigation to an arbitrary URL.
 
     Args:
         action:
@@ -477,7 +479,7 @@ def find_elements(
           use get_content.
         - Need to click one of several matches -> use click_element with nth.
         - Need to know whether an element is present/visible ->
-          use check_condition.
+          use check_if_condition.
 
     Notes:
         Element handles cannot be persisted across MCP calls. If you find
@@ -542,8 +544,8 @@ def get_content(
         - Need visible text, html, or URLs on a page -> use get_content.
         - Need structured information about matching elements ->
           use find_elements.
-        - Need to check element presence/visibility -> use check_condition.
-        - Need to wait for content to appear -> use wait_for.
+        - Need to check element presence/visibility -> use check_if_condition.
+        - Need to wait for content to appear -> use wait_for_condition.
 
     If there's no matching element found within the timeout,
         then @handle_sb_errors returns details from the exception raised.
@@ -592,7 +594,8 @@ def get_attributes(
         - Need to discover multiple matching elements or inspect their text ->
           use 'find_elements'.
         - Need visible text or HTML content -> use 'get_content'.
-        - Need to check element presence/visibility -> use 'check_condition'.
+        - Need to check element presence/visibility ->
+          use 'check_if_condition'.
 
     This is a read-only operation.
 
@@ -609,7 +612,7 @@ def get_attributes(
 
 @mcp.tool()
 @handle_sb_errors
-def check_condition(
+def check_if_condition(
     check: Literal["present", "visible"] = "visible",
     selector: str = "body",
     text: str | None = None,
@@ -618,9 +621,10 @@ def check_condition(
     for the condition to become true.
 
     Use this tool when you need an immediate boolean observation of the current
-    page state. Use wait_for when the condition may become true later and the
-    workflow should wait for it. Use assert_condition when the condition is an
-    expected requirement and failure should be treated as an assertion error.
+    page state. Use wait_for_condition when the condition may become true later
+    and the workflow should wait for it. Use assert_condition when the
+    condition is an expected requirement and failure should be treated as an
+    assertion error.
 
     Args:
         check:
@@ -645,8 +649,8 @@ def check_condition(
         exception. If there's an error, returns a string with error details.
 
     Tool selection:
-        - Immediate boolean observation -> use check_condition.
-        - Wait for a state/content transition -> use wait_for.
+        - Immediate boolean observation -> use check_if_condition.
+        - Wait for a state/content transition -> use wait_for_condition.
         - Verify an expected condition -> use assert_condition.
         - Need element details of matching elements -> use find_elements.
         - Need to read page or element content -> use get_content.
@@ -654,7 +658,7 @@ def check_condition(
     Notes:
         This tool does not intentionally wait for elements or text to appear.
         It is intended for checking the current state only. If page timing or
-        asynchronous loading matters, use wait_for instead.
+        asynchronous loading matters, use wait_for_condition instead.
 
         When `text` is provided, `check` is ignored.
     """
@@ -696,11 +700,11 @@ def click_element(
     parent element.
 
     Selection behavior:
-    - `nth` is 1-based and takes precedence over every other click mode.
-    - Otherwise, `all_matches=True` clicks every currently visible match.
-    - Otherwise, `only_if_visible=True` clicks only if a match is visible.
-    - Otherwise, `parent_selector` scopes the click to a nested element.
-    - With none of the above, performs a normal SeleniumBase click.
+        - `nth` is 1-based and takes precedence over every other click mode.
+        - Otherwise, `all_matches=True` clicks every currently visible match.
+        - Otherwise, `only_if_visible=True` clicks only if a match is visible.
+        - Otherwise, `parent_selector` scopes the click to a nested element.
+        - With none of the above, performs a normal SeleniumBase click.
 
     Args:
         selector: CSS selector, XPath selector, or supported SeleniumBase
@@ -709,15 +713,15 @@ def click_element(
             clicks; do not use them with `all_matches=True`.
 
         nth: 1-based occurrence to click when multiple elements match.
-            Must be >= 1. Takes precedence over `all_matches`,
+            Must be >= 1 if provided. Takes precedence over `all_matches`,
             `only_if_visible`, and `parent_selector`.
 
         all_matches: If True, click every currently visible matching element
             in order of appearance. Ignored when `nth` is provided. Use only
             when multiple clicks are intentionally desired, such as for
             clicking all the checkboxes in a section of a webpage.
-            If a click induces page navigation, then subsequent clicks are
-            cancelled.
+            If any of the click actions induces page navigation, then
+            subsequent clicks are cancelled without any exceptions raised.
 
         only_if_visible: If True, click only when the target is already
             visible; do not wait for it to become visible.
@@ -733,18 +737,27 @@ def click_element(
             indexed click. Default: True.
 
     Examples:
-        - Click one element: `click_element("button.submit")`
-        - Click the 2nd matching element: `click_element("button", nth=2)`
-        - Click all visible matches:
-          `click_element(".dismiss", all_matches=True)`
-        - Click only if already visible:
-          `click_element("#menu", only_if_visible=True)`
-        - Click inside a container:
-          `click_element(".item", parent_selector="#result")`
+        - Click the first button: `click_element("button")`
+        - Click the 2nd button: `click_element("button", nth=2)`
+        - Click all checkboxes:
+          `click_element('input[type="checkbox"]', all_matches=True)`
+        - Click the first visible link:
+          `click_element("a", only_if_visible=True)`
+        - Click the first button that's inside the first iframe:
+          `click_element("button", parent_selector="iframe")`
+
+    Error behavior:
+        With the exception of using 'only_if_visible=True', if there's no
+        matching element found within the timeout, then @handle_sb_errors
+        returns details from the exception raised.
+
+    When not to use:
+        - Do not use this tool if you need to hover an element first before
+          clicking; use hover_action with action="hover_and_click" instead.
     """
     sb = _get_sb()
 
-    if nth is not None:
+    if nth:
         if nth < 1:
             return "Error: nth must be >= 1."
         sb.click_nth_element(selector, nth, scroll=scroll)
@@ -769,9 +782,10 @@ def click_element(
 @mcp.tool()
 @handle_sb_errors
 def hover_action(
-    selector1: str,
-    selector2: str | None = None,
+    selector: str,
+    secondary_selector: str | None = None,
     action: Literal["hover", "hover_and_click", "drag_and_drop"] = "hover",
+    timeout: float = 5,
 ) -> str:
     """Hover over an element, optionally click another, or drag-and-drop.
 
@@ -779,51 +793,71 @@ def hover_action(
     drag-and-drop operations.
 
     Args:
-        selector1:
+        selector:
             The primary element selector.
             For action="hover", this is the element to hover over.
             For action="hover_and_click", this is the element to hover over
-            before clicking selector2.
+            before clicking 'secondary_selector'.
             For action="drag_and_drop", this is the draggable source element.
 
-        selector2:
+        secondary_selector:
             The secondary element selector.
             Required for action="hover_and_click", where it identifies
-            the element revealed or targeted after hovering selector1.
+            the element to click after hovering 'selector'.
             Required for action="drag_and_drop", where it identifies the
             destination/drop target.
             Not used for action="hover".
 
         action:
-            - "hover": Hover over selector1 only.
-            - "hover_and_click": Hover over selector1, then click selector2.
-            - "drag_and_drop": Drag selector1 and drop it onto selector2.
+            - "hover": Hover over 'selector' only.
+            - "hover_and_click": Hover over 'selector', then click
+              'secondary_selector' after a short moment has passed.
+            - "drag_and_drop": Drag 'selector' and drop it onto
+              'secondary_selector'.
+
+        timeout: Maximum seconds to wait for 'selector'.
+            For drag_and_drop, the same timeout applies to secondary_selector.
+            For hover_and_click, SeleniumBase uses its own short wait for
+            secondary_selector; this parameter does not extend that secondary
+            wait.
 
     Returns:
-        A confirmation message describing the performed operation.
+        A confirmation message describing the performed operation's result.
 
-    Tool selection:
-        - Simple hover -> action="hover".
-        - Hover over one element and click another -> action="hover_and_click".
-        - Drag one element onto another -> action="drag_and_drop".
+    Error behavior:
+        If a required element cannot be found or interacted with within the
+        applicable wait period, or if an error occurs during the action, the
+        resulting exception message is returned through @handle_sb_errors.
+        Failing actions such as failed hover_and_click will raise exceptions.
+
+    When not to use:
+        - Do not use this tool to click if you don't need to hover an element
+          before clicking another; use 'click' instead.
     """
     sb = _get_sb()
 
+    if timeout < 0:
+        return "Error: timeout must be >= 0."
+
     if action == "hover":
-        sb.hover_element(selector1)
-        return f"Hovered {selector1}"
+        sb.hover_element(selector, timeout=timeout)
+        return f"Hovered {selector}"
 
     if action == "hover_and_click":
-        if selector2 is None:
-            return "Error: action='click' requires selector2."
-        sb.hover_and_click(selector1, selector2)
-        return f"Hovered {selector1} and clicked {selector2}"
+        if not secondary_selector:
+            return (
+                "Error: action='hover_and_click' requires secondary_selector."
+            )
+        sb.hover_and_click(selector, secondary_selector, timeout=timeout)
+        return f"Hovered {selector} and clicked {secondary_selector}"
 
     if action == "drag_and_drop":
-        if selector2 is None:
-            return "Error: action='drag_and_drop' requires selector2."
-        sb.drag_and_drop(selector1, selector2)
-        return f"Dragged {selector1} onto {selector2}"
+        if not secondary_selector:
+            return (
+                "Error: action='drag_and_drop' requires secondary_selector."
+            )
+        sb.drag_and_drop(selector, secondary_selector, timeout=timeout)
+        return f"Dragged {selector} onto {secondary_selector}"
 
     return (
         f"Error: unknown action '{action}'. "
@@ -998,7 +1032,7 @@ def focus_element(
 
 @mcp.tool()
 @handle_sb_errors
-def wait_for(
+def wait_for_condition(
     state: Literal[
         "present",
         "visible",
@@ -1017,7 +1051,7 @@ def wait_for(
     condition is met or the timeout expires. It does not intentionally scroll,
     click, or otherwise modify the page while waiting.
 
-    Use check_condition to inspect the current state without waiting.
+    Use check_if_condition to inspect the current state without waiting.
     Use assert_condition to verify an expected condition rather than
     synchronize with a changing page.
 
@@ -1056,8 +1090,8 @@ def wait_for(
         the tool returns the error produced by its error handler.
 
     Tool selection:
-        - Inspect current state immediately -> check_condition.
-        - Wait for a state change -> wait_for.
+        - Inspect current state immediately -> check_if_condition.
+        - Wait for a state change -> wait_for_condition.
         - Verify an expectation -> assert_condition.
     """
     sb = _get_sb()
@@ -1132,10 +1166,10 @@ def assert_condition(
     handled by `handle_sb_errors` and returned as a descriptive tool error;
     it is not reported as a successful result.
 
-    Unlike check_condition, this tool does not merely return whether a
+    Unlike check_if_condition, this tool does not merely return whether a
     condition is true: a failed expectation is an error.
-    Unlike wait_for, its purpose is to verify an expectation, not merely
-    synchronize with a changing page.
+    Unlike wait_for_condition, its purpose is to verify an expectation,
+    not merely synchronize with a changing page.
 
     Args:
         check:
@@ -1169,8 +1203,8 @@ def assert_condition(
         instead of a success message.
 
     Tool selection:
-        - Inspect a condition without failing -> check_condition.
-        - Wait for a condition to become true -> wait_for.
+        - Inspect a condition without failing -> check_if_condition.
+        - Wait for a condition to become true -> wait_for_condition.
         - Verify that an expected condition is true -> assert_condition.
     """
     sb = _get_sb()
@@ -1389,11 +1423,14 @@ def scroll_page(
             up/down scrolling. For example, amount=25 scrolls approximately
             one quarter of the viewport height.
 
-    Values greater than 100 for `amount` are allowed.
-    For example, 200 means approximately two viewport heights.
+    Notes:
+        Values greater than 100 for `amount` are allowed.
+        For example, 200 means approximately two viewport heights.
 
-    Use focus_element(action="scroll_to_element") when the goal is to reveal
-    a specific element rather than scroll the page by a relative amount.
+    Tool selection:
+        - Need to reveal a specific element ->
+          use 'focus_element' with action="scroll_to_element".
+        - Need to scroll the page by a relative amount -> use 'scroll_page'.
     """
     sb = _get_sb()
 
@@ -1454,8 +1491,9 @@ def manage_window(
 
         height: Window height for "set_rect".
 
-    Use this tool for browser-window geometry and state.
-    Use `manage_tabs` for switching between browser tabs.
+    Notes:
+        Use this tool for browser-window geometry and state.
+        Use `manage_tabs` for switching between browser tabs.
     """
     sb = _get_sb()
 
@@ -1486,12 +1524,12 @@ def manage_window(
 @handle_sb_errors
 def manage_tabs(
     action: Literal[
-        "list",
-        "open",
-        "switch",
-        "switch_newest",
-        "close_active",
-    ] = "list",
+        "list_tabs",
+        "open_new_tab",
+        "switch_to_tab",
+        "switch_to_newest_tab",
+        "close_active_tab",
+    ] = "list_tabs",
     url: str | None = None,
     tab_index: int | None = None,
     switch_to: bool = True,
@@ -1499,29 +1537,38 @@ def manage_tabs(
     """Manage browser tabs, including opening new ones.
 
     Use this for listing, opening, switching, or closing tabs.
-    Use `goto_url` and `manage_history` for navigation within the active tab.
+    Use `open_url` and `manage_history` for navigation within the active tab.
 
     Args:
         action:
-            - "list": Return each tab's index, URL, and title.
-              Use this to find the tab_index for "switch".
-            - "open": Open a new tab, optionally navigating it to `url`.
-            - "switch": Switch to the tab at tab_index from "list".
-            - "switch_newest": Switch to the newest tab.
-            - "close_active": Close the active tab.
+            - "list_tabs": Return each tab's index, URL, and title.
+              Use this to find the tab_index for "switch_to_tab".
+            - "open_new_tab": Open a new tab, optionally navigating to `url`.
+            - "switch_to_tab": Switch to the tab at tab_index from "list_tabs".
+            - "switch_to_newest_tab": Switch to the newest tab.
+            - "close_active_tab": Close the active tab. This action must be
+              followed by a 'manage_tabs' action that switches to a new
+              tab, such as "switch_to_tab" or "switch_to_newest_tab".
+
+        url: URL for "open_new_tab". If not provided, "about:blank" is used.
 
-        url: URL for "open".
+        tab_index: Tab index from "list_tabs" that is only used for the
+            "switch_to_tab" action.)
 
-        tab_index: Tab index from "list" for "switch".
+        switch_to: If using "open_new_tab", switch to the new tab when True.
 
-        switch_to: For "open", switch to the new tab when True.
+    Notes:
+        Tab indexes are session-relative and may change after tabs are opened
+        or closed. Use "list_tabs" to get current indexes before switching
+        by index.
 
-    Tab indexes are session-relative and may change after tabs are opened or
-    closed. Use "list" to get current indexes before switching by index.
+    Error behavior:
+        If there's an error during any of the tab actions, then
+        @handle_sb_errors will propagate the exception as an error message.
     """
     sb = _get_sb()
 
-    if action == "list":
+    if action == "list_tabs":
         tabs = sb.get_tabs()
         return [
             {
@@ -1532,11 +1579,13 @@ def manage_tabs(
             for i, t in enumerate(tabs)
         ]
 
-    if action == "open":
+    if action == "open_new_tab":
+        if not url:
+            url = "about:blank"
         sb.open_new_tab(url=url, switch_to=switch_to)
         return f"Opened new tab (url={url!r}, switch_to={switch_to})"
 
-    if action == "switch":
+    if action == "switch_to_tab":
         if tab_index is None:
             return (
                 "Error: action='switch' requires tab_index "
@@ -1554,17 +1603,17 @@ def manage_tabs(
         sb.switch_to_tab(tabs[tab_index])
         return f"Switched to tab {tab_index}"
 
-    if action == "switch_newest":
+    if action == "switch_to_newest_tab":
         sb.switch_to_newest_tab()
         return "Switched to newest tab."
 
-    if action == "close_active":
+    if action == "close_active_tab":
         sb.close_active_tab()
         return "Closed active tab."
 
     return (
-        f"Error: unknown action '{action}'. Use 'list', 'open', 'switch', "
-        f"'switch_newest', or 'close_active'."
+        f"Error: unknown action '{action}'. Use 'list_tabs', 'open_new_tab', "
+        f"'switch_to_tab', 'switch_to_newest_tab', or 'close_active_tab'."
     )
 
 
@@ -1580,12 +1629,12 @@ def solve_captcha() -> str:
 
     This tool attempts to interact with CAPTCHA controls such as Cloudflare
     Turnstile, reCAPTCHA, hCaptcha, DataDome Slider, or FriendlyCaptcha via
-    the Chrome DevTools Protocol (CDP), which is stealthier than JavaScript
-    actions because CDP actions can avoid triggering `isTrusted: false`.
+    the Chrome DevTools Protocol (CDP), which is usually stealthier than
+    JavaScript because CDP actions can avoid triggering `isTrusted: false`.
 
     This tool automatically detects the coordinates of CAPTCHA checkboxes
     for determining the correct location to perform the click. If no CAPTCHA
-    is detected on the current page, then no click action is performed.
+    is detected on the current page, then no click action is attempted.
 
     The tool does not guarantee that the CAPTCHA was solved. Some CAPTCHA
     controls are embedded inside shadow DOM or otherwise do not expose an
@@ -1595,13 +1644,13 @@ def solve_captcha() -> str:
     Tool workflow:
         1. Inspect the webpage with get_content when you need to
            determine whether CAPTCHA-related controls are present.
-        2. Call solve_captcha to attempt the CAPTCHA interaction.
-        3. Use get_page_info, get_content, check_condition,
-           or manage_cookies to inspect resulting page/session state.
+        2. Call 'solve_captcha' to attempt the CAPTCHA interaction.
+        3. Use 'get_page_info', 'get_content', 'check_if_condition',
+           or 'manage_cookies' to inspect resulting page/session state.
 
     Returns:
         A message confirming that the CAPTCHA interaction was attempted.
-        (There's no guarantee that the CAPTCHA challenge was solved.)
+        The message is the same for both successful and failed attempts.
     """
     sb = _get_sb()
     sb.solve_captcha()

{seleniumbase-4.54.3 → seleniumbase-4.54.5}/requirements.txt

@@ -65,7 +65,7 @@ rich>=15.0.0,<16
 # --- Testing Requirements --- #
 # ("pip install -r requirements.txt" also installs this, but "pip install -e ." won't.)
 
-coverage>=7.16.0
+coverage>=7.16.1
 pytest-cov>=7.1.0
 flake8==7.3.0
 mccabe==0.7.0

{seleniumbase-4.54.3 → seleniumbase-4.54.5}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.54.3"
+__version__ = "4.54.5"

{seleniumbase-4.54.3 → seleniumbase-4.54.5}/seleniumbase/core/sb_cdp.py

@@ -3034,8 +3034,10 @@ class CDPMethods():
             self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.1))
 
-    def hover_element(self, selector, timeframe=0.27):
-        element = self.select(selector)
+    def hover_element(self, selector, timeframe=0.27, timeout=None):
+        if not timeout:
+            timeout = settings.SMALL_TIMEOUT
+        element = self.select(selector, timeout=timeout)
         gui_lock = FileLock(constants.MultiBrowser.PYAUTOGUILOCK)
         with gui_lock:
             self.bring_active_window_to_front()
@@ -3043,11 +3045,13 @@ class CDPMethods():
             element.mouse_move()
             time.sleep(timeframe)
 
-    def hover_and_click(self, hover_selector, click_selector):
+    def hover_and_click(self, hover_selector, click_selector, timeout=None):
+        if not timeout:
+            timeout = settings.SMALL_TIMEOUT
         if getattr(sb_config, "_cdp_mobile_mode", None):
-            self.select(click_selector).click()
+            self.select(click_selector, timeout=timeout).click()
             return
-        hover_element = self.select(hover_selector)
+        hover_element = self.select(hover_selector, timeout=timeout)
         gui_lock = FileLock(constants.MultiBrowser.PYAUTOGUILOCK)
         with gui_lock:
             self.bring_active_window_to_front()

{seleniumbase-4.54.3 → seleniumbase-4.54.5}/seleniumbase/fixtures/base_case.py

@@ -2772,7 +2772,7 @@ class BaseCase(unittest.TestCase):
         original_by = by
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.hover_element(selector)
+            self.cdp.hover_element(selector, timeout=timeout)
             return
         self.wait_for_element_visible(
             original_selector, by=original_by, timeout=timeout
@@ -2817,7 +2817,9 @@ class BaseCase(unittest.TestCase):
             click_selector, click_by
         )
         if self.__is_cdp_swap_needed():
-            self.cdp.hover_and_click(hover_selector, click_selector)
+            self.cdp.hover_and_click(
+                hover_selector, click_selector, timeout=timeout
+            )
             return
         dropdown_element = self.wait_for_element_visible(
             original_selector, by=original_by, timeout=timeout

{seleniumbase-4.54.3 → seleniumbase-4.54.5/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.54.3
+Version: 4.54.5
 Summary: SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -126,7 +126,7 @@ Requires-Dist: allure-pytest>=2.16.0; extra == "allure"
 Requires-Dist: allure-python-commons>=2.16.0; extra == "allure"
 Requires-Dist: allure-behave>=2.16.0; extra == "allure"
 Provides-Extra: coverage
-Requires-Dist: coverage>=7.16.0; extra == "coverage"
+Requires-Dist: coverage>=7.16.1; extra == "coverage"
 Requires-Dist: pytest-cov>=7.1.0; extra == "coverage"
 Provides-Extra: flake8
 Requires-Dist: flake8==7.3.0; extra == "flake8"