seleniumbase 4.26.2__tar.gz → 4.26.4__tar.gz

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seleniumbase
-Version: 4.26.2
+Version: 4.26.4
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -117,7 +117,8 @@ Requires-Dist: behave==1.2.6
 Requires-Dist: soupsieve==2.4.1; python_version < "3.8"
 Requires-Dist: soupsieve==2.5; python_version >= "3.8"
 Requires-Dist: beautifulsoup4==4.12.3
-Requires-Dist: pygments==2.17.2
+Requires-Dist: pygments==2.17.2; python_version < "3.8"
+Requires-Dist: pygments==2.18.0; python_version >= "3.8"
 Requires-Dist: pyreadline3==3.4.1; platform_system == "Windows"
 Requires-Dist: tabcompleter==1.3.0
 Requires-Dist: pdbp==1.5.0
@@ -133,7 +134,7 @@ Requires-Dist: allure-python-commons>=2.13.5; extra == "allure"
 Requires-Dist: allure-behave>=2.13.5; extra == "allure"
 Provides-Extra: coverage
 Requires-Dist: coverage==7.2.7; python_version < "3.8" and extra == "coverage"
-Requires-Dist: coverage>=7.5.0; python_version >= "3.8" and extra == "coverage"
+Requires-Dist: coverage>=7.5.1; python_version >= "3.8" and extra == "coverage"
 Requires-Dist: pytest-cov==4.1.0; python_version < "3.8" and extra == "coverage"
 Requires-Dist: pytest-cov>=5.0.0; python_version >= "3.8" and extra == "coverage"
 Provides-Extra: flake8
@@ -151,7 +152,7 @@ Provides-Extra: pdfminer
 Requires-Dist: pdfminer.six==20221105; python_version < "3.8" and extra == "pdfminer"
 Requires-Dist: pdfminer.six==20231228; python_version >= "3.8" and extra == "pdfminer"
 Requires-Dist: cryptography==39.0.2; python_version < "3.9" and extra == "pdfminer"
-Requires-Dist: cryptography==42.0.5; python_version >= "3.9" and extra == "pdfminer"
+Requires-Dist: cryptography==42.0.7; python_version >= "3.9" and extra == "pdfminer"
 Requires-Dist: cffi==1.15.1; python_version < "3.8" and extra == "pdfminer"
 Requires-Dist: cffi==1.16.0; python_version >= "3.8" and extra == "pdfminer"
 Requires-Dist: pycparser==2.22; extra == "pdfminer"
@@ -161,7 +162,7 @@ Requires-Dist: Pillow>=10.3.0; python_version >= "3.8" and extra == "pillow"
 Provides-Extra: pip-system-certs
 Requires-Dist: pip-system-certs==4.0; platform_system == "Windows" and extra == "pip-system-certs"
 Provides-Extra: proxy
-Requires-Dist: proxy.py==2.4.3; extra == "proxy"
+Requires-Dist: proxy.py==2.4.4; extra == "proxy"
 Provides-Extra: psutil
 Requires-Dist: psutil==5.9.8; extra == "psutil"
 Provides-Extra: selenium-stealth
@@ -844,6 +845,7 @@ pytest test_coffee_cart.py --trace
 --block-images  # (Block images from loading during tests.)
 --do-not-track  # (Indicate to websites that you don't want to be tracked.)
 --verify-delay=SECONDS  # (The delay before MasterQA verification checks.)
+--ee | --esc-end  # (Lets the user end the current test via the ESC key.)
 --recorder  # (Enables the Recorder for turning browser actions into code.)
 --rec-behave  # (Same as Recorder Mode, but also generates behave-gherkin.)
 --rec-sleep  # (If the Recorder is enabled, also records self.sleep calls.)

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/README.md

@@ -671,6 +671,7 @@ pytest test_coffee_cart.py --trace
 --block-images  # (Block images from loading during tests.)
 --do-not-track  # (Indicate to websites that you don't want to be tracked.)
 --verify-delay=SECONDS  # (The delay before MasterQA verification checks.)
+--ee | --esc-end  # (Lets the user end the current test via the ESC key.)
 --recorder  # (Enables the Recorder for turning browser actions into code.)
 --rec-behave  # (Same as Recorder Mode, but also generates behave-gherkin.)
 --rec-sleep  # (If the Recorder is enabled, also records self.sleep calls.)

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/examples/raw_parameter_script.py

@@ -76,6 +76,7 @@ if pure_python:
     sb._reuse_session = False
     sb._crumbs = False
     sb._final_debug = False
+    sb.esc_end = False
     sb.use_wire = False
     sb.enable_3d_apis = False
     sb.window_size = None

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/examples/uc_cdp_events.py

@@ -14,7 +14,7 @@ class CDPTests(BaseCase):
 
     def click_turnstile_and_verify(sb):
         sb.switch_to_frame("iframe")
-        sb.driver.uc_click("span.mark")
+        sb.driver.uc_click("span")
         sb.assert_element("img#captcha-success", timeout=3)
         sb.highlight("img#captcha-success", loops=8)
 

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/help_docs/customizing_test_runs.md

@@ -164,6 +164,7 @@ pytest my_first_test.py --settings-file=custom_settings.py
 --block-images  # (Block images from loading during tests.)
 --do-not-track  # (Indicate to websites that you don't want to be tracked.)
 --verify-delay=SECONDS  # (The delay before MasterQA verification checks.)
+--ee | --esc-end  # (Lets the user end the current test via the ESC key.)
 --recorder  # (Enables the Recorder for turning browser actions into code.)
 --rec-behave  # (Same as Recorder Mode, but also generates behave-gherkin.)
 --rec-sleep  # (If the Recorder is enabled, also records self.sleep calls.)

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/help_docs/method_summary.md

@@ -386,6 +386,8 @@ self.highlight_if_visible(selector, by="css selector", loops=4, scroll=True)
 
 self.highlight(selector, by="css selector", loops=4, scroll=True, timeout=None)
 
+self.highlight_elements(selector, by="css selector", loops=4, scroll=True, limit=0)
+
 self.press_up_arrow(selector="html", times=1, by="css selector")
 
 self.press_down_arrow(selector="html", times=1, by="css selector")
@@ -1044,6 +1046,8 @@ driver.uc_open_with_tab(url)  # (New tab with default reconnect_time)
 
 driver.uc_open_with_reconnect(url, reconnect_time=None)  # (New tab)
 
+driver.uc_open_with_disconnect(url)  # Open in new tab + disconnect()
+
 driver.reconnect(timeout)  # disconnect() + sleep(timeout) + connect()
 
 driver.disconnect()  # Stops the webdriver service to prevent detection

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/help_docs/recorder_mode.md

@@ -121,6 +121,8 @@ pytest TEST_NAME.py --trace --rec -s
 
 ⏺️ Inside recorded tests, you might find the <code>self.open_if_not_url(URL)</code> method, which opens the URL given if the browser is not currently on that page. SeleniumBase uses this method in recorded scripts when the Recorder detects that a browser action changed the current URL. This method prevents an unnecessary page load and shows what page the test visited after a browser action.
 
+⏺️ By launching the Recorder App with <code>sbase recorder --ee</code>, you can end the recording by pressing {<code>SHIFT</code>+<code>ESC</code>} instead of the usual way of ending the recording by typing <code>c</code> from a <code>breakpoint()</code> and pressing <code>Enter</code>. Those buttons don't need to be pressed at the same time, but <code>SHIFT</code> must be pressed directly before <code>ESC</code>.
+
 --------
 
 <div>To learn more about SeleniumBase, check out the Docs Site:</div>

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/mkdocs_build/requirements.txt

@@ -1,26 +1,26 @@
 # mkdocs dependencies for generating the seleniumbase.io website
 # Minimum Python version: 3.8 (for generating docs only)
 
-regex>=2024.4.28
+regex>=2024.5.10
 pymdown-extensions>=10.8.1
-pipdeptree>=2.19.1
+pipdeptree>=2.20.0
 python-dateutil>=2.8.2
 Markdown==3.6
 markdown2==2.4.13
 MarkupSafe==2.1.5
-Jinja2==3.1.3
+Jinja2==3.1.4
 click==8.1.7
 ghp-import==2.1.0
 watchdog==4.0.0
 cairocffi==1.7.0
 pathspec==0.12.1
-Babel==2.14.0
+Babel==2.15.0
 paginate==0.5.6
 lxml==5.2.1
 pyquery==2.0.0
 readtime==3.0.0
 mkdocs==1.6.0
-mkdocs-material==9.5.20
+mkdocs-material==9.5.22
 mkdocs-exclude-search==0.6.6
 mkdocs-simple-hooks==0.1.5
 mkdocs-material-extensions==1.3.1

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/requirements.txt

@@ -57,7 +57,8 @@ behave==1.2.6
 soupsieve==2.4.1;python_version<"3.8"
 soupsieve==2.5;python_version>="3.8"
 beautifulsoup4==4.12.3
-pygments==2.17.2
+pygments==2.17.2;python_version<"3.8"
+pygments==2.18.0;python_version>="3.8"
 pyreadline3==3.4.1;platform_system=="Windows"
 tabcompleter==1.3.0
 pdbp==1.5.0
@@ -72,7 +73,7 @@ rich==13.7.1
 # ("pip install -r requirements.txt" also installs this, but "pip install -e ." won't.)
 
 coverage==7.2.7;python_version<"3.8"
-coverage>=7.5.0;python_version>="3.8"
+coverage>=7.5.1;python_version>="3.8"
 pytest-cov==4.1.0;python_version<"3.8"
 pytest-cov>=5.0.0;python_version>="3.8"
 flake8==5.0.4;python_version<"3.9"

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.26.2"
+__version__ = "4.26.4"

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/console_scripts/ReadMe.md

@@ -406,6 +406,7 @@ sbase codegen new_test.py --url=wikipedia.org
 ``--edge``  (Use Edge browser instead of Chrome.)
 ``--gui`` / ``--headed``  (Use headed mode on Linux.)
 ``--uc`` / ``--undetected``  (Use undetectable mode.)
+``--ee``  (Use SHIFT + ESC to end the recording.)
 ``--overwrite``  (Overwrite file when it exists.)
 ``--behave``  (Also output Behave/Gherkin files.)
 

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/console_scripts/run.py

@@ -310,6 +310,7 @@ def show_mkrec_usage():
     print("           --edge  (Use Edge browser instead of Chrome.)")
     print("           --gui / --headed  (Use headed mode on Linux.)")
     print("           --uc / --undetected  (Use undetectable mode.)")
+    print("           --ee  (Use SHIFT + ESC to end the recording.)")
     print("           --overwrite  (Overwrite file when it exists.)")
     print("           --behave  (Also output Behave/Gherkin files.)")
     print("  Output:")
@@ -336,6 +337,7 @@ def show_codegen_usage():
     print("           --edge  (Use Edge browser instead of Chrome.)")
     print("           --gui / --headed  (Use headed mode on Linux.)")
     print("           --uc / --undetected  (Use undetectable mode.)")
+    print("           --ee  (Use SHIFT + ESC to end the recording.)")
     print("           --overwrite  (Overwrite file when it exists.)")
     print("           --behave  (Also output Behave/Gherkin files.)")
     print("  Output:")

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/console_scripts/sb_mkrec.py

@@ -93,6 +93,7 @@ def main():
     invalid_cmd = None
     use_edge = False
     use_uc = False
+    esc_end = False
     start_page = None
     next_is_url = False
     use_colors = True
@@ -145,6 +146,8 @@ def main():
                 help_me = True
             elif option.lower() == "--edge":
                 use_edge = True
+            elif option.lower() == "--ee":
+                esc_end = True
             elif option.lower() in ("--gui", "--headed"):
                 if "linux" in sys.platform:
                     force_gui = True
@@ -183,6 +186,42 @@ def main():
     data.append('            # type "c", and press [Enter].')
     data.append("            import pdb; pdb.set_trace()")
     data.append("")
+
+    if esc_end:
+        msg = ">>> Use [SHIFT + ESC] in the browser to end recording!"
+        d2 = []
+        d2.append("from seleniumbase import BaseCase")
+        d2.append("")
+        d2.append("")
+        d2.append("class RecorderTest(BaseCase):")
+        d2.append("    def test_recording(self):")
+        d2.append("        if self.recorder_ext:")
+        d2.append("            print(")
+        d2.append('                "\\n\\n%s\\n"' % msg)
+        d2.append("            )")
+        d2.append('            script = self._get_rec_shift_esc_script()')
+        d2.append('            esc = "return document.sb_esc_end;"')
+        d2.append("            start_time = self.time()")
+        d2.append("            last_handles_num = self._get_num_handles()")
+        d2.append("            for i in range(1200):")
+        d2.append("                try:")
+        d2.append("                    self.execute_script(script)")
+        d2.append("                    handles_num = self._get_num_handles()")
+        d2.append("                    if handles_num < 1:")
+        d2.append("                        return")
+        d2.append("                    elif handles_num != last_handles_num:")
+        d2.append("                        self.switch_to_window(-1)")
+        d2.append("                        last_handles_num = handles_num")
+        d2.append('                    if self.execute_script(esc) == "yes":')
+        d2.append("                        return")
+        d2.append("                    elif self.time() - start_time > 600:")
+        d2.append("                        return")
+        d2.append("                    self.sleep(0.5)")
+        d2.append("                except Exception:")
+        d2.append("                    return")
+        d2.append("")
+        data = d2
+
     file = codecs.open(file_path, "w+", "utf-8")
     file.writelines("\r\n".join(data))
     file.close()

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/console_scripts/sb_recorder.py

@@ -162,6 +162,8 @@ def do_recording(file_name, url, overwrite_enabled, use_chrome, window):
             or "--undetectable" in command_args
         ):
             command += " --uc"
+        if "--ee" in command_args:
+            command += " --ee"
         command += add_on
         poll = None
         if sb_config.rec_subprocess_used:

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/core/browser_launcher.py

@@ -443,8 +443,32 @@ def uc_open_with_reconnect(driver, url, reconnect_time=None):
         js_utils.call_me_later(driver, script, 3)
         time.sleep(0.007)
         driver.close()
-        driver.reconnect(reconnect_time)
-        driver.switch_to.window(driver.window_handles[-1])
+        if reconnect_time == "disconnect":
+            driver.disconnect()
+            time.sleep(0.007)
+        else:
+            driver.reconnect(reconnect_time)
+            driver.switch_to.window(driver.window_handles[-1])
+    else:
+        driver.default_get(url)  # The original one
+    return None
+
+
+def uc_open_with_disconnect(driver, url):
+    """Open a url and disconnect chromedriver.
+    Note: You can't perform Selenium actions again
+    until after you've called driver.connect()."""
+    if url.startswith("//"):
+        url = "https:" + url
+    elif ":" not in url:
+        url = "https://" + url
+    if (url.startswith("http:") or url.startswith("https:")):
+        script = 'window.open("%s","_blank");' % url
+        js_utils.call_me_later(driver, script, 3)
+        time.sleep(0.007)
+        driver.close()
+        driver.disconnect()
+        time.sleep(0.007)
     else:
         driver.default_get(url)  # The original one
     return None
@@ -3754,6 +3778,11 @@ def get_local_driver(
                             driver, *args, **kwargs
                         )
                     )
+                    driver.uc_open_with_disconnect = (
+                        lambda *args, **kwargs: uc_open_with_disconnect(
+                            driver, *args, **kwargs
+                        )
+                    )
                     driver.uc_click = lambda *args, **kwargs: uc_click(
                         driver, *args, **kwargs
                     )

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/fixtures/base_case.py

@@ -60,6 +60,7 @@ from selenium.common.exceptions import (
 from selenium.webdriver.common.by import By
 from selenium.webdriver.common.keys import Keys
 from selenium.webdriver.remote.remote_connection import LOGGER
+from selenium.webdriver.remote.webelement import WebElement
 from seleniumbase import config as sb_config
 from seleniumbase.__version__ import __version__
 from seleniumbase.common import decorators
@@ -113,6 +114,7 @@ class BaseCase(unittest.TestCase):
         ]
         self.version_tuple = tuple(self.version_list)
         self.version_info = self.version_tuple
+        self.time = time.time
         self.__page_sources = []
         self.__extra_actions = []
         self.__js_start_time = 0
@@ -380,6 +382,7 @@ class BaseCase(unittest.TestCase):
         self, selector, by="css selector", timeout=None, delay=0, scroll=True
     ):
         self.__check_scope()
+        self.__skip_if_esc()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -670,6 +673,7 @@ class BaseCase(unittest.TestCase):
                 self.__demo_mode_pause_if_active(tiny=True)
         elif self.slow_mode:
             self.__slow_mode_pause_if_active()
+        self.__set_esc_skip()
 
     def slow_click(self, selector, by="css selector", timeout=None):
         """Similar to click(), but pauses for a brief moment before clicking.
@@ -1585,6 +1589,7 @@ class BaseCase(unittest.TestCase):
     def click_link_text(self, link_text, timeout=None):
         """This method clicks link text on a page."""
         self.__check_scope()
+        self.__skip_if_esc()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -4141,6 +4146,10 @@ class BaseCase(unittest.TestCase):
                 self.uc_open_with_tab = new_driver.uc_open_with_tab
             if hasattr(new_driver, "uc_open_with_reconnect"):
                 self.uc_open_with_reconnect = new_driver.uc_open_with_reconnect
+            if hasattr(new_driver, "uc_open_with_disconnect"):
+                self.uc_open_with_disconnect = (
+                    new_driver.uc_open_with_disconnect
+                )
             if hasattr(new_driver, "reconnect"):
                 self.reconnect = new_driver.reconnect
             if hasattr(new_driver, "disconnect"):
@@ -4403,11 +4412,35 @@ class BaseCase(unittest.TestCase):
         for cookie_dict in cookies:
             self.driver.add_cookie(cookie_dict)
 
+    def __set_esc_skip(self):
+        if hasattr(self, "esc_end") and self.esc_end:
+            script = (
+                """document.onkeydown = function(evt) {
+                    evt = evt || window.event;
+                    var isEscape = false;
+                    if ("key" in evt) {
+                        isEscape = (evt.key === "Escape" || evt.key === "Esc");
+                    } else {
+                        isEscape = (evt.keyCode === 27);
+                    }
+                    if (isEscape) {
+                        document.sb_esc_end = 'yes';
+                    }
+                };"""
+            )
+            self.execute_script(script)
+
+    def __skip_if_esc(self):
+        if hasattr(self, "esc_end") and self.esc_end:
+            if self.execute_script("return document.sb_esc_end;") == "yes":
+                self.skip()
+
     def wait_for_ready_state_complete(self, timeout=None):
         """Waits for the "readyState" of the page to be "complete".
         Returns True when the method completes."""
         self.__check_scope()
         self._check_browser()
+        self.__skip_if_esc()
         if not timeout:
             timeout = settings.EXTREME_TIMEOUT
         if self.timeout_multiplier and timeout == settings.EXTREME_TIMEOUT:
@@ -4426,6 +4459,7 @@ class BaseCase(unittest.TestCase):
             time.sleep(0.01)
             if self.undetectable:
                 time.sleep(0.035)
+        self.__set_esc_skip()
         return True
 
     def wait_for_angularjs(self, timeout=None, **kwargs):
@@ -5645,6 +5679,40 @@ class BaseCase(unittest.TestCase):
         if self.is_element_visible(selector, by=by):
             self.__highlight(selector, by=by, loops=loops, scroll=scroll)
 
+    def __highlight_element(self, element, loops=None, scroll=True):
+        self.__check_scope()
+        if not loops:
+            loops = settings.HIGHLIGHTS
+        if scroll and self.browser != "safari":
+            try:
+                self.__slow_scroll_to_element(element)
+            except Exception:
+                pass
+        if self.highlights:
+            loops = self.highlights
+        if self.browser == "ie":
+            loops = 1  # Override previous setting because IE is slow
+        loops = int(loops)
+        if self.headless or self.headless2 or self.xvfb:
+            # Headless modes have less need for highlighting elements.
+            # However, highlight() may be used as a sleep alternative.
+            loops = int(math.ceil(loops * 0.5))
+        o_bs = ""  # original_box_shadow
+        try:
+            style = element.get_attribute("style")
+        except Exception:
+            self.wait_for_ready_state_complete()
+            time.sleep(0.12)
+            style = element.get_attribute("style")
+        if style:
+            if "box-shadow: " in style:
+                box_start = style.find("box-shadow: ")
+                box_end = style.find(";", box_start) + 1
+                original_box_shadow = style[box_start:box_end]
+                o_bs = original_box_shadow
+        self.__highlight_element_with_js(element, loops, o_bs)
+        time.sleep(0.065)
+
     def __highlight(
         self, selector, by="css selector", loops=None, scroll=True
     ):
@@ -5733,13 +5801,17 @@ class BaseCase(unittest.TestCase):
     ):
         """This method uses fancy JavaScript to highlight an element.
         @Params
-        selector - the selector of the element to find
+        selector - the selector of the element to find (Accepts WebElement)
         by - the type of selector to search by (Default: CSS)
         loops - # of times to repeat the highlight animation
                 (Default: 4. Each loop lasts for about 0.2s)
         scroll - the option to scroll to the element first (Default: True)
         timeout - the time to wait for the element to appear """
         self.__check_scope()
+        self.__skip_if_esc()
+        if isinstance(selector, WebElement):
+            self.__highlight_element(selector, loops=loops, scroll=scroll)
+            return
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.wait_for_element_visible(selector, by=by, timeout=timeout)
@@ -5751,6 +5823,31 @@ class BaseCase(unittest.TestCase):
                 action = ["hi_li", selector, origin, time_stamp]
                 self.__extra_actions.append(action)
 
+    def highlight_elements(
+        self,
+        selector,
+        by="css selector",
+        loops=None,
+        scroll=True,
+        limit=0,
+    ):
+        if not limit:
+            limit = 0  # 0 means no limit
+        limit = int(limit)
+        count = 0
+        elements = self.find_elements(selector, by=by)
+        for element in elements:
+            try:
+                if element.is_displayed():
+                    self.__highlight_element(
+                        element, loops=loops, scroll=scroll
+                    )
+                    count += 1
+            except Exception:
+                pass
+            if limit > 0 and count >= limit:
+                break
+
     def press_up_arrow(self, selector="html", times=1, by="css selector"):
         """Simulates pressing the UP Arrow on the keyboard.
         By default, "html" will be used as the CSS Selector target.
@@ -6697,10 +6794,7 @@ class BaseCase(unittest.TestCase):
                 constants.PipInstall.FINDLOCK
             )
             with pip_find_lock:
-                if (
-                    sys.version_info >= (3, 7)
-                    and sys.version_info < (3, 9)
-                ):
+                if sys.version_info < (3, 9):
                     # Fix bug in newer cryptography for Python 3.7 and 3.8:
                     # "pyo3_runtime.PanicException: Python API call failed"
                     try:
@@ -8646,6 +8740,7 @@ class BaseCase(unittest.TestCase):
     ):
         """Same as self.wait_for_element()"""
         self.__check_scope()
+        self.__skip_if_esc()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -13415,6 +13510,7 @@ class BaseCase(unittest.TestCase):
             self.slow_scroll_to(selector, by=by)
 
     def __demo_mode_highlight_if_active(self, selector, by):
+        self.__skip_if_esc()
         if self.demo_mode:
             # Includes self.slow_scroll_to(selector, by=by) by default
             self.__highlight(selector, by=by)
@@ -14316,6 +14412,7 @@ class BaseCase(unittest.TestCase):
             self.firefox_arg = sb_config.firefox_arg
             self.firefox_pref = sb_config.firefox_pref
             self.verify_delay = sb_config.verify_delay
+            self.esc_end = sb_config.esc_end
             self.recorder_mode = sb_config.recorder_mode
             self.recorder_ext = sb_config.recorder_mode
             self.rec_print = sb_config.rec_print
@@ -15635,6 +15732,31 @@ class BaseCase(unittest.TestCase):
         else:
             return None
 
+    def _get_num_handles(self):
+        return len(self.driver.window_handles)
+
+    def _get_rec_shift_esc_script(self):
+        return (
+            """document.onkeydown = function(evt) {
+                evt = evt || window.event;
+                var isEscape = false;
+                if ("key" in evt) {
+                    isEscape = (evt.key === "Escape" || evt.key === "Esc");
+                    last_key = evt.key;
+                } else {
+                    isEscape = (evt.keyCode === 27);
+                    last_key = evt.keyCode;
+                    if (last_key === 16) {
+                        last_key = "Shift";
+                    }
+                }
+                if (isEscape && document.sb_last_key === "Shift") {
+                    document.sb_esc_end = "yes";
+                }
+                document.sb_last_key = last_key;
+            };"""
+        )
+
     def _addSkip(self, result, test_case, reason):
         """This method should NOT be called directly from tests."""
         addSkip = getattr(result, 'addSkip', None)
@@ -15765,6 +15887,11 @@ class BaseCase(unittest.TestCase):
             )
             raise Exception(message)
         # *** Start tearDown() officially ***
+        if self.undetectable:
+            try:
+                self.driver.window_handles
+            except urllib3.exceptions.MaxRetryError:
+                self.driver.connect()
         self.__slow_mode_pause_if_active()
         has_exception = self.__has_exception()
         sb_config._has_exception = has_exception

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/plugins/pytest_plugin.py

@@ -81,6 +81,7 @@ def pytest_addoption(parser):
     --block-images  (Block images from loading during tests.)
     --do-not-track  (Indicate to websites that you don't want to be tracked.)
     --verify-delay=SECONDS  (The delay before MasterQA verification checks.)
+    --ee / --esc-end  (Lets the user end the current test via the ESC key.)
     --recorder  (Enables the Recorder for turning browser actions into code.)
     --rec-behave  (Same as Recorder Mode, but also generates behave-gherkin.)
     --rec-sleep  (If the Recorder is enabled, also records self.sleep calls.)
@@ -895,6 +896,16 @@ def pytest_addoption(parser):
         help="""Setting this overrides the default wait time
                 before each MasterQA verification pop-up.""",
     )
+    parser.addoption(
+        "--esc-end",
+        "--esc_end",
+        "--ee",
+        action="store_true",
+        dest="esc_end",
+        default=False,
+        help="""End the current test early via the ESC key.
+                The test will be marked as skipped.""",
+    )
     parser.addoption(
         "--recorder",
         "--record",
@@ -1549,6 +1560,7 @@ def pytest_configure(config):
     sb_config.block_images = config.getoption("block_images")
     sb_config.do_not_track = config.getoption("do_not_track")
     sb_config.verify_delay = config.getoption("verify_delay")
+    sb_config.esc_end = config.getoption("esc_end")
     sb_config.recorder_mode = config.getoption("recorder_mode")
     sb_config.recorder_ext = config.getoption("recorder_mode")  # Again
     sb_config.rec_behave = config.getoption("rec_behave")

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/plugins/selenium_plugin.py

@@ -60,6 +60,7 @@ class SeleniumBrowser(Plugin):
     --block-images  (Block images from loading during tests.)
     --do-not-track  (Indicate to websites that you don't want to be tracked.)
     --verify-delay=SECONDS  (The delay before MasterQA verification checks.)
+    --ee / --esc-end  (Lets the user end the current test via the ESC key.)
     --recorder  (Enables the Recorder for turning browser actions into code.)
     --rec-behave  (Same as Recorder Mode, but also generates behave-gherkin.)
     --rec-sleep  (If the Recorder is enabled, also records self.sleep calls.)
@@ -613,6 +614,16 @@ class SeleniumBrowser(Plugin):
             help="""Setting this overrides the default wait time
                     before each MasterQA verification pop-up.""",
         )
+        parser.addoption(
+            "--esc-end",
+            "--esc_end",
+            "--ee",
+            action="store_true",
+            dest="esc_end",
+            default=False,
+            help="""End the current test early via the ESC key.
+                    The test will be marked as skipped.""",
+        )
         parser.addoption(
             "--recorder",
             "--record",
@@ -1126,6 +1137,7 @@ class SeleniumBrowser(Plugin):
         test.test.block_images = self.options.block_images
         test.test.do_not_track = self.options.do_not_track
         test.test.verify_delay = self.options.verify_delay  # MasterQA
+        test.test.esc_end = self.options.esc_end
         test.test.recorder_mode = self.options.recorder_mode
         test.test.recorder_ext = self.options.recorder_mode  # Again
         test.test.rec_behave = self.options.rec_behave

{seleniumbase-4.26.2 → seleniumbase-4.26.4}/seleniumbase/undetected/webelement.py

@@ -14,7 +14,7 @@ class WebElement(selenium.webdriver.remote.webelement.WebElement):
     ):
         if driver and selector and by:
             delayed_click = False
-            if tag_name in ["span", "button", "div", "a"]:
+            if tag_name in ["span", "button", "div", "a", "b", "input"]:
                 delayed_click = True
             if delayed_click and ":contains" not in selector:
                 selector = js_utils.convert_to_css_selector(selector, by)