seleniumbase 4.47.5__tar.gz → 4.47.7__tar.gz

{seleniumbase-4.47.5/seleniumbase.egg-info → seleniumbase-4.47.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.47.5
+Version: 4.47.7
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -262,9 +262,9 @@ Dynamic: summary
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -280,6 +280,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -292,6 +293,7 @@ from seleniumbase import SB
 with SB(uc=True, test=True) as sb:
     url = "https://google.com/ncr"
     sb.activate_cdp_mode(url)
+    sb.click_if_visible('button:contains("Accept all")')
     sb.type('[name="q"]', "SeleniumBase GitHub page")
     sb.click('[value="Google Search"]')
     sb.sleep(4)  # The "AI Overview" sometimes loads
@@ -691,6 +693,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -779,7 +782,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems:

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/README.md

@@ -62,9 +62,9 @@
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -80,6 +80,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -92,6 +93,7 @@ from seleniumbase import SB
 with SB(uc=True, test=True) as sb:
     url = "https://google.com/ncr"
     sb.activate_cdp_mode(url)
+    sb.click_if_visible('button:contains("Accept all")')
     sb.type('[name="q"]', "SeleniumBase GitHub page")
     sb.click('[value="Google Search"]')
     sb.sleep(4)  # The "AI Overview" sometimes loads
@@ -491,6 +493,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -579,7 +582,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems:

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/__version__.py

@@ -1,2 +1,2 @@
 # seleniumbase package
-__version__ = "4.47.5"
+__version__ = "4.47.7"

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/console_scripts/sb_mkdir.py

@@ -712,6 +712,9 @@ def main():
     data.append("        if not self.undetectable:")
     data.append("            self.get_new_driver(undetectable=True)")
     data.append('        self.open("https://google.com/ncr")')
+    data.append(
+        "        sb.click_if_visible('button:contains(\"Accept all\")')"
+    )
     data.append('        self.assert_title_contains("Google")')
     data.append("        self.save_screenshot_to_logs()")
     data.append('        self.type(HomePage.search_box, "github.com")')

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/core/browser_launcher.py

@@ -942,6 +942,7 @@ def uc_open_with_cdp_mode(driver, url=None, **kwargs):
     cdp.assert_not_equal = CDPM.assert_not_equal
     cdp.assert_in = CDPM.assert_in
     cdp.assert_not_in = CDPM.assert_not_in
+    cdp.js_scroll_into_view = CDPM.js_scroll_into_view
     cdp.scroll_into_view = CDPM.scroll_into_view
     cdp.scroll_to_y = CDPM.scroll_to_y
     cdp.scroll_by_y = CDPM.scroll_by_y

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/core/sb_cdp.py

@@ -66,6 +66,7 @@ class CDPMethods():
             lambda *args, **kwargs: self.__gui_click(element, *args, **kwargs)
         )
         element.highlight_overlay = lambda: self.__highlight_overlay(element)
+        element.is_in_viewport = lambda: self.__is_in_viewport(element)
         element.mouse_click = lambda: self.__mouse_click(element)
         element.click_with_offset = (
             lambda *args, **kwargs: self.__mouse_click_with_offset_async(
@@ -429,7 +430,7 @@ class CDPMethods():
                     visible_elements.append(element)
         return visible_elements
 
-    def click_nth_element(self, selector, number):
+    def click_nth_element(self, selector, number, scroll=True):
         elements = self.select_all(selector)
         if len(elements) < number:
             raise Exception(
@@ -440,10 +441,11 @@ class CDPMethods():
         if number < 0:
             number = 0
         element = elements[number]
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.click()
 
-    def click_nth_visible_element(self, selector, number):
+    def click_nth_visible_element(self, selector, number, scroll=True):
         """Finds all matching page elements and clicks the nth visible one.
         Example: self.click_nth_visible_element('[type="checkbox"]', 5)
                 (Clicks the 5th visible checkbox on the page.)"""
@@ -457,7 +459,8 @@ class CDPMethods():
         if number < 0:
             number = 0
         element = elements[number]
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.click()
 
     def click_link(self, link_text):
@@ -541,6 +544,11 @@ class CDPMethods():
             self.loop.run_until_complete(element.highlight_overlay_async())
         )
 
+    def __is_in_viewport(self, element):
+        return (
+            self.loop.run_until_complete(element.is_in_viewport_async())
+        )
+
     def __mouse_click(self, element):
         result = (
             self.loop.run_until_complete(element.mouse_click_async())
@@ -793,13 +801,14 @@ class CDPMethods():
         js_code = js_code.replace("return getBestSelector", "getBestSelector")
         return self.loop.run_until_complete(self.page.evaluate(js_code))
 
-    def click(self, selector, timeout=None):
+    def click(self, selector, timeout=None, scroll=True):
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.__slow_mode_pause_if_set()
         element = self.find_element(selector, timeout=timeout)
-        element.scroll_into_view()
         tag_name = element.tag_name
+        current_url = self.get_current_url()
+
         if tag_name:
             tag_name = tag_name.lower().strip()
         if (
@@ -807,12 +816,24 @@ class CDPMethods():
                 "a", "button", "canvas", "div", "input", "li", "span", "label"
             ]
             and "contains(" not in selector
+            and "://google" not in current_url
+            and "://www.google" not in current_url
         ):
+            if scroll:
+                element.scroll_into_view()
             try:
                 element.mouse_click()  # Simulated click (NOT PyAutoGUI)
             except Exception:
                 element.click()  # Standard CDP click
         else:
+            if scroll:
+                if "contains(" in selector:
+                    element.scroll_into_view()
+                else:
+                    try:
+                        self.js_scroll_into_view(selector)
+                    except Exception:
+                        element.scroll_into_view()
             element.click()  # Standard CDP click
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.2))
@@ -824,10 +845,10 @@ class CDPMethods():
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.2))
 
-    def click_if_visible(self, selector, timeout=0):
+    def click_if_visible(self, selector, timeout=0, scroll=True):
         if self.is_element_visible(selector):
             with suppress(Exception):
-                self.click(selector, timeout=1)
+                self.click(selector, timeout=1, scroll=scroll)
         elif timeout == 0:
             return
         else:
@@ -836,7 +857,7 @@ class CDPMethods():
                 if self.is_element_visible(selector):
                     self.click(selector, timeout=1)
 
-    def click_visible_elements(self, selector, limit=0):
+    def click_visible_elements(self, selector, limit=0, scroll=True):
         """Finds all matching page elements and clicks visible ones in order.
         If a click reloads or opens a new page, the clicking will stop.
         If no matching elements appear, an Exception will be raised.
@@ -859,7 +880,8 @@ class CDPMethods():
                 except Exception:
                     continue
                 if (width != 0 or height != 0):
-                    element.scroll_into_view()
+                    if scroll:
+                        element.scroll_into_view()
                     element.click()
                     click_count += 1
                     time.sleep(0.044)
@@ -868,13 +890,14 @@ class CDPMethods():
             except Exception:
                 break
 
-    def mouse_click(self, selector, timeout=None):
+    def mouse_click(self, selector, timeout=None, scroll=True):
         """(Attempt simulating a mouse click)"""
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         self.__slow_mode_pause_if_set()
         element = self.find_element(selector, timeout=timeout)
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         element.mouse_click()
         self.__slow_mode_pause_if_set()
         self.loop.run_until_complete(self.page.wait(0.2))
@@ -1970,9 +1993,10 @@ class CDPMethods():
             py = element_rect["y"]
             self.gui_click_x_y(px + x, py + y, timeframe=timeframe)
 
-    def click_with_offset(self, selector, x, y, center=False):
+    def click_with_offset(self, selector, x, y, center=False, scroll=True):
         element = self.find_element(selector)
-        element.scroll_into_view()
+        if scroll:
+            element.scroll_into_view()
         if "--debug" in sys.argv:
             displayed_selector = "`%s`" % selector
             if '"' not in selector:
@@ -3103,6 +3127,17 @@ class CDPMethods():
         if first in second:
             raise AssertionError("%s is in %s" % (first, second))
 
+    def js_scroll_into_view(self, selector):
+        css_selector = self.__convert_to_css_if_xpath(selector)
+        css_selector = re.escape(css_selector)  # Add "\\" to special chars
+        css_selector = js_utils.escape_quotes_if_needed(css_selector)
+        js_code = (
+            "document.querySelector('%s')?.scrollIntoView();"
+            % css_selector
+        )
+        with suppress(Exception):
+            self.loop.run_until_complete(self.page.evaluate(js_code))
+
     def scroll_into_view(self, selector):
         self.find_element(selector).scroll_into_view()
         self.loop.run_until_complete(self.page.wait(0.1))

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/fixtures/base_case.py

@@ -411,7 +411,7 @@ class BaseCase(unittest.TestCase):
         original_by = by
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click(selector, timeout=timeout)
+            self.cdp.click(selector, timeout=timeout, scroll=scroll)
             return
         if delay and (type(delay) in [int, float]) and delay > 0:
             time.sleep(delay)
@@ -2254,7 +2254,7 @@ class BaseCase(unittest.TestCase):
         )
 
     def click_visible_elements(
-        self, selector, by="css selector", limit=0, timeout=None
+        self, selector, by="css selector", limit=0, timeout=None, scroll=True
     ):
         """Finds all matching page elements and clicks visible ones in order.
         If a click reloads or opens a new page, the clicking will stop.
@@ -2270,7 +2270,7 @@ class BaseCase(unittest.TestCase):
             timeout = self.__get_new_timeout(timeout)
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click_visible_elements(selector, limit)
+            self.cdp.click_visible_elements(selector, limit, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
@@ -2297,7 +2297,8 @@ class BaseCase(unittest.TestCase):
                 return
             try:
                 if element.is_displayed():
-                    self.__scroll_to_element(element)
+                    if scroll:
+                        self.__scroll_to_element(element)
                     if self.browser == "safari":
                         self.execute_script("arguments[0].click();", element)
                     else:
@@ -2311,7 +2312,8 @@ class BaseCase(unittest.TestCase):
                 time.sleep(0.12)
                 try:
                     if element.is_displayed():
-                        self.__scroll_to_element(element)
+                        if scroll:
+                            self.__scroll_to_element(element)
                         if self.browser == "safari":
                             self.execute_script(
                                 "arguments[0].click();", element
@@ -2348,7 +2350,7 @@ class BaseCase(unittest.TestCase):
             self.__switch_to_newest_window_if_not_blank()
 
     def click_nth_visible_element(
-        self, selector, number, by="css selector", timeout=None
+        self, selector, number, by="css selector", timeout=None, scroll=True
     ):
         """Finds all matching page elements and clicks the nth visible one.
         Example: self.click_nth_visible_element('[type="checkbox"]', 5)
@@ -2360,7 +2362,7 @@ class BaseCase(unittest.TestCase):
             timeout = self.__get_new_timeout(timeout)
         selector, by = self.__recalculate_selector(selector, by)
         if self.__is_cdp_swap_needed():
-            self.cdp.click_nth_visible_element(selector, number)
+            self.cdp.click_nth_visible_element(selector, number, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         self.wait_for_element_present(selector, by=by, timeout=timeout)
@@ -2379,7 +2381,8 @@ class BaseCase(unittest.TestCase):
             pre_action_url = self.driver.current_url
         pre_window_count = len(self.driver.window_handles)
         try:
-            self.__scroll_to_element(element)
+            if scroll:
+                self.__scroll_to_element(element)
             self.__element_click(element)
         except (Stale_Exception, ENI_Exception, ECI_Exception):
             time.sleep(0.12)
@@ -2409,18 +2412,20 @@ class BaseCase(unittest.TestCase):
         ):
             self.__switch_to_newest_window_if_not_blank()
 
-    def click_if_visible(self, selector, by="css selector", timeout=0):
+    def click_if_visible(
+        self, selector, by="css selector", timeout=0, scroll=True
+    ):
         """If the page selector exists and is visible, clicks on the element.
         This method only clicks on the first matching element found.
         Use click_visible_elements() to click all matching elements.
         If a "timeout" is provided, waits that long for the element
         to appear before giving up and returning without a click()."""
         if self.__is_cdp_swap_needed():
-            self.cdp.click_if_visible(selector, timeout=timeout)
+            self.cdp.click_if_visible(selector, timeout=timeout, scroll=scroll)
             return
         self.wait_for_ready_state_complete()
         if self.is_element_visible(selector, by=by):
-            self.click(selector, by=by)
+            self.click(selector, by=by, scroll=scroll)
         elif timeout > 0:
             with suppress(Exception):
                 self.wait_for_element_visible(
@@ -2428,7 +2433,7 @@ class BaseCase(unittest.TestCase):
                 )
                 self.sleep(0.2)
             if self.is_element_visible(selector, by=by):
-                self.click(selector, by=by)
+                self.click(selector, by=by, scroll=scroll)
 
     def click_active_element(self):
         if self.__is_cdp_swap_needed():
@@ -2484,6 +2489,7 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         """Click an element at an {X,Y}-offset location.
         {0,0} is the top-left corner of the element.
@@ -2500,6 +2506,7 @@ class BaseCase(unittest.TestCase):
             mark=mark,
             timeout=timeout,
             center=center,
+            scroll=scroll,
         )
 
     def double_click_with_offset(
@@ -2511,6 +2518,7 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         """Double click an element at an {X,Y}-offset location.
         {0,0} is the top-left corner of the element.
@@ -2527,6 +2535,7 @@ class BaseCase(unittest.TestCase):
             mark=mark,
             timeout=timeout,
             center=center,
+            scroll=scroll,
         )
 
     def is_checked(self, selector, by="css selector", timeout=None):
@@ -14043,9 +14052,12 @@ class BaseCase(unittest.TestCase):
         mark=None,
         timeout=None,
         center=None,
+        scroll=True,
     ):
         if self.__is_cdp_swap_needed():
-            self.cdp.click_with_offset(selector, x, y, center=center)
+            self.cdp.click_with_offset(
+                selector, x, y, center=center, scroll=scroll
+            )
             return
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
@@ -14061,9 +14073,13 @@ class BaseCase(unittest.TestCase):
         if self.demo_mode:
             self.__highlight(selector, by=by, loops=1)
         elif self.slow_mode:
-            self.__slow_scroll_to_element(element)
+            if scroll:
+                self.__slow_scroll_to_element(element)
+            else:
+                self.sleep(0.2)
         else:
-            self.__scroll_to_element(element, selector, by)
+            if scroll:
+                self.__scroll_to_element(element, selector, by)
         self.wait_for_ready_state_complete()
         if self.__needs_minimum_wait():
             time.sleep(0.03)

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/plugins/sb_manager.py

@@ -13,6 +13,7 @@ from seleniumbase import SB
 with SB(uc=True, test=True) as sb:
     url = "https://google.com/ncr"
     sb.activate_cdp_mode(url)
+    sb.click_if_visible('button:contains("Accept all")')
     sb.type('[name="q"]', "SeleniumBase GitHub page")
     sb.click('[value="Google Search"]')
     sb.sleep(2)
@@ -148,6 +149,7 @@ def SB(
         with SB(uc=True, test=True) as sb:
             url = "https://google.com/ncr"
             sb.activate_cdp_mode(url)
+            sb.click_if_visible('button:contains("Accept all")')
             sb.type('[name="q"]', "SeleniumBase GitHub page")
             sb.click('[value="Google Search"]')
             sb.sleep(2)

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/undetected/cdp_driver/element.py

@@ -467,8 +467,8 @@ class Element:
                 raise Exception("Could not find position for %s " % self)
             pos = Position(quads[0])
             if abs:
-                scroll_y = (await self.tab.evaluate("window.scrollY")).value
-                scroll_x = (await self.tab.evaluate("window.scrollX")).value
+                scroll_y = (await self.tab.evaluate("window.scrollY"))
+                scroll_x = (await self.tab.evaluate("window.scrollX"))
                 abs_x = pos.left + scroll_x + (pos.width / 2)
                 abs_y = pos.top + scroll_y + (pos.height / 2)
                 pos.abs_x = abs_x
@@ -717,6 +717,31 @@ class Element:
             )
         )
 
+    async def is_in_viewport_async(self):
+        try:
+            layout = await self.tab.send(
+                cdp.page.get_layout_metrics()
+            )
+            viewport = layout[4]
+            v_left = viewport.page_x
+            v_top = viewport.page_y
+            v_right = v_left + viewport.client_width
+            v_bottom = v_top + viewport.client_height
+            box = await self.tab.send(
+                cdp.dom.get_box_model(backend_node_id=self.backend_node_id)
+            )
+            quad = box.content
+            e_left = min(quad[0], quad[2], quad[4], quad[6])
+            e_top = min(quad[1], quad[3], quad[5], quad[7])
+            e_right = max(quad[0], quad[2], quad[4], quad[6])
+            e_bottom = max(quad[1], quad[3], quad[5], quad[7])
+            return (
+                e_left >= v_left and e_right <= v_right
+                and e_top >= v_top and e_bottom <= v_bottom
+            )
+        except Exception:
+            return False
+
     async def scroll_into_view_async(self):
         """Scrolls element into view."""
         try:

{seleniumbase-4.47.5 → seleniumbase-4.47.7}/seleniumbase/undetected/cdp_driver/tab.py

@@ -226,7 +226,6 @@ class Tab(Connection):
         except (Exception, TypeError):
             pass
         while not item:
-            await self
             item = await self.find_element_by_text(
                 text, best_match, return_enclosing_element
             )
@@ -1629,11 +1628,17 @@ class Tab(Connection):
                     await element.click_async()
 
     async def click_with_offset(self, selector, x, y, center=False, timeout=5):
+        """Click an element at an {X,Y}-offset location.
+        {0,0} is the top-left corner of the element.
+        This method is used to click on CAPTCHAs."""
         element = await self.find(selector, timeout=timeout)
         await element.scroll_into_view_async()
         await element.mouse_click_with_offset_async(x=x, y=y, center=center)
 
     async def solve_captcha(self):
+        """This method does a few things to click a CAPTCHA:
+        1. Checks to see if a CAPTCHA is on the current page.
+        2. If found, calls `click_with_offset(*)` to click it."""
         await self.sleep(0.11)
         source = await self.get_html()
         if await self.__on_a_cf_turnstile_page(source):

{seleniumbase-4.47.5 → seleniumbase-4.47.7/seleniumbase.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seleniumbase
-Version: 4.47.5
+Version: 4.47.7
 Summary: A complete web automation framework for end-to-end testing.
 Home-page: https://github.com/seleniumbase/SeleniumBase
 Author: Michael Mintz
@@ -262,9 +262,9 @@ Dynamic: summary
 
 --------
 
-<p align="left">📓 Here's the stealthy architecture overview:</p>
+<h3 align="left">⚙️ Stealthy architecture flowchart:</h3>
 
-<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture overview" />
+<img src="https://seleniumbase.github.io/other/sb_stealth.png" width="596" alt="Stealthy architecture flowchart" />
 
 (For maximum stealth, use <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/ReadMe.md">CDP Mode</a>, which includes <a translate="no" href="https://github.com/seleniumbase/SeleniumBase/blob/master/examples/cdp_mode/playwright/ReadMe.md">Stealthy Playwright Mode</a>)
 
@@ -280,6 +280,7 @@ sb = sb_cdp.Chrome(url)
 elements = sb.find_elements("span.titleline > a")
 for element in elements:
     print("* " + element.text)
+sb.driver.stop()
 ```
 
 --------
@@ -292,6 +293,7 @@ from seleniumbase import SB
 with SB(uc=True, test=True) as sb:
     url = "https://google.com/ncr"
     sb.activate_cdp_mode(url)
+    sb.click_if_visible('button:contains("Accept all")')
     sb.type('[name="q"]', "SeleniumBase GitHub page")
     sb.click('[value="Google Search"]')
     sb.sleep(4)  # The "AI Overview" sometimes loads
@@ -691,6 +693,7 @@ class MyTestClass(BaseCase):
 
 ```python
 self.open(url)  # Navigate the browser window to the URL.
+self.activate_cdp_mode()  # Activate CDP Mode from UC Mode.
 self.type(selector, text)  # Update the field with the text.
 self.click(selector)  # Click the element with the selector.
 self.click_link(link_text)  # Click the link containing text.
@@ -779,7 +782,7 @@ pytest [FILE_NAME.py]::[CLASS_NAME]::[METHOD_NAME]
 pynose [FILE_NAME.py]:[CLASS_NAME].[METHOD_NAME]
 ```
 
-<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>). This means <b>you no longer need random <span><code translate="no">time.sleep()</code></span> statements</b> in your scripts.</p>
+<p>✅ No More Flaky Tests! SeleniumBase methods automatically wait for page elements to finish loading before interacting with them (<i>up to a timeout limit</i>).</p>
 <img src="https://img.shields.io/badge/Flaky%20Tests%3F-%20NO%21-11BBDD.svg" alt="NO MORE FLAKY TESTS!" />
 
 ✅ SeleniumBase supports all major browsers and operating systems: