Update examples

mdmintz · mdmintz · commit 41666ae76004 · 2026-06-05T01:15:03.000-04:00
diff --git a/examples/cdp_mode/raw_ad_blocking.py b/examples/cdp_mode/raw_ad_blocking.py
@@ -1,3 +1,5 @@
+"""Test Ad-Blocking using mycdp.network.set_blocked_urls().
+tab.send() is the stealthy version of execute_cdp_cmd()."""
 import mycdp
 from seleniumbase import decorators
 from seleniumbase import sb_cdp
@@ -28,4 +30,4 @@ async def block_urls(tab):
     sb.assert_false("doubleclick.net" in source)
     sb.assert_false("google-analytics.com" in source)
     sb.post_message("Blocking was successful!")
-    sb.driver.quit()
+    sb.quit()
diff --git a/examples/cdp_mode/raw_antibot.py b/examples/cdp_mode/raw_antibot.py
@@ -1,14 +1,15 @@
+"""CDP Mode bypasses bot-detection and performs stealthy actions.
+sb.press_keys() is a slower sb.type() for human-like speed."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
     url = "https://seleniumbase.io/antibot/login"
     sb.activate_cdp_mode(url)
     sb.press_keys("input#username", "demo_user")
-    sb.press_keys("input#password", "secret_pass")
+    sb.type("input#password", "secret_pass")
     sb.click("button#myButton")
-    sb.sleep(1.5)
+    sb.sleep(1.4)
     sb.click("a#log-in")
     sb.assert_text("Welcome!", "h1")
     sb.set_messenger_theme(location="bottom_center")
     sb.post_message("SeleniumBase wasn't detected!")
-    sb.sleep(1.5)
diff --git a/examples/cdp_mode/raw_basic_cdp.py b/examples/cdp_mode/raw_basic_cdp.py
@@ -1,7 +1,7 @@
 from seleniumbase import sb_cdp
 
-url = "https://seleniumbase.io/simple/login"
-sb = sb_cdp.Chrome(url)
+sb = sb_cdp.Chrome()
+sb.open("https://seleniumbase.io/simple/login")
 sb.type("#username", "demo_user")
 sb.type("#password", "secret_pass")
 sb.click('a:contains("Sign in")')
@@ -14,4 +14,4 @@
     print(nav_item.text)
 sb.click_link("Sign out")
 sb.assert_text("signed out", "#top_message")
-sb.driver.stop()
+sb.quit()
diff --git a/examples/cdp_mode/raw_cdp_pixelscan.py b/examples/cdp_mode/raw_cdp_pixelscan.py
@@ -1,6 +1,6 @@
 from seleniumbase import sb_cdp
 
-sb = sb_cdp.Chrome(incognito=True)
+sb = sb_cdp.Chrome(guest=True, ad_block=True)
 sb.open("https://pixelscan.net/fingerprint-check")
 sb.sleep(1)
 sb.wait_for_element("pxlscn-dynamic-ad")
@@ -13,3 +13,4 @@
 sb.highlight("span.status-success")
 sb.highlight("pxlscn-fingerprint-masking p")
 sb.highlight("pxlscn-bot-detection p")
+print("Bot Not Detected")
diff --git a/examples/cdp_mode/raw_cdp_tavus.py b/examples/cdp_mode/raw_cdp_tavus.py
@@ -0,0 +1,9 @@
+from seleniumbase import sb_cdp
+
+sb = sb_cdp.Chrome()
+sb.open("platform.tavus.io/auth/sign-in?is_developer=true")
+sb.sleep(3)
+sb.solve_captcha()
+sb.sleep(1)
+sb.assert_element('input[type="email"]')
+sb.assert_element('button[type="submit"]')
diff --git a/examples/cdp_mode/raw_cdp_walmart.py b/examples/cdp_mode/raw_cdp_walmart.py
@@ -43,4 +43,5 @@
                 price_text = price_text.split("current price ")[-1]
                 price_text = price_text.split(" ")[0]
                 print("  (" + price_text + ")")
+                item.scroll_into_view()
 sb.driver.stop()
diff --git a/examples/cdp_mode/raw_cf.py b/examples/cdp_mode/raw_cf.py
@@ -1,4 +1,5 @@
-"""Using CDP Mode to bypass CAPTCHAs in different ways."""
+"""Using CDP Mode to bypass CAPTCHAs in different ways.
+PyAutoGUI is installed automatically if not already."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True, guest=True) as sb:
diff --git a/examples/cdp_mode/raw_mfa_login.py b/examples/cdp_mode/raw_mfa_login.py
@@ -1,12 +1,12 @@
 from seleniumbase import sb_cdp
 
-url = "https://seleniumbase.io/realworld/login"
-sb = sb_cdp.Chrome(url)
+sb = sb_cdp.Chrome()
+sb.open("https://seleniumbase.io/realworld/login")
 sb.type("#username", "demo_user")
 sb.type("#password", "secret_pass")
 sb.enter_mfa_code("#totpcode", "GAXG2MTEOR3DMMDG")
 sb.assert_text("Welcome!", "h1")
 sb.click('a:contains("This Page")')
 sb.highlight("h1")
 sb.highlight("img#image1")
-sb.driver.stop()
+sb.quit()
diff --git a/examples/cdp_mode/raw_mobile_roblox.py b/examples/cdp_mode/raw_mobile_roblox.py
@@ -1,3 +1,5 @@
+"""Test mobile emulation via mycdp.emulation.set_device_metrics_override().
+tab.send() is a stealthy version of Selenium's execute_cdp_cmd() method."""
 import mycdp
 from seleniumbase import SB
 
diff --git a/examples/cdp_mode/raw_multi_cdp.py b/examples/cdp_mode/raw_multi_cdp.py
@@ -12,7 +12,7 @@ def main(url):
     sb.highlight("button")
     sb.click("button")
     sb.sleep(2)
-    sb.driver.quit()
+    sb.quit()
 
 
 if __name__ == "__main__":
diff --git a/examples/cdp_mode/raw_pixelscan.py b/examples/cdp_mode/raw_pixelscan.py
@@ -1,6 +1,6 @@
 from seleniumbase import SB
 
-with SB(uc=True, test=True, incognito=True, ad_block=True) as sb:
+with SB(uc=True, test=True, guest=True, ad_block=True) as sb:
     url = "https://pixelscan.net/fingerprint-check"
     sb.activate_cdp_mode(url)
     sb.sleep(1)
@@ -14,3 +14,4 @@
     sb.cdp.highlight("span.status-success")
     sb.cdp.highlight("pxlscn-fingerprint-masking p")
     sb.cdp.highlight("pxlscn-bot-detection p")
+    print("Bot Not Detected")
diff --git a/examples/cdp_mode/raw_tavus.py b/examples/cdp_mode/raw_tavus.py
@@ -0,0 +1,10 @@
+from seleniumbase import SB
+
+with SB(uc=True, test=True) as sb:
+    sb.activate_cdp_mode()
+    sb.open("platform.tavus.io/auth/sign-in?is_developer=true")
+    sb.sleep(3)
+    sb.solve_captcha()
+    sb.sleep(1)
+    sb.assert_element('input[type="email"]')
+    sb.assert_element('button[type="submit"]')
diff --git a/examples/cdp_mode/raw_walmart.py b/examples/cdp_mode/raw_walmart.py
@@ -44,3 +44,4 @@
                     price_text = price_text.split("current price ")[-1]
                     price_text = price_text.split(" ")[0]
                     print("  (" + price_text + ")")
+                    item.scroll_into_view()
diff --git a/examples/cdp_mode/raw_wsform.py b/examples/cdp_mode/raw_wsform.py
@@ -1,9 +1,12 @@
+"""CDP Mode for bypassing bot-detection & CAPTCHAs.
+Note: sb.uc_gui_click_captcha() requires PyAutoGUI,
+which is installed automatically if not already."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True, locale="en", incognito=True) as sb:
     url = "https://wsform.com/demo/"
     sb.activate_cdp_mode(url)
     sb.sleep(2)
     sb.scroll_into_view("div.grid")
-    sb.uc_gui_click_captcha()
+    sb.uc_gui_click_captcha()  # PyAutoGUI mouse click
     sb.sleep(2)
diff --git a/examples/presenter/multi_uc.py b/examples/presenter/multi_uc.py
@@ -1,4 +1,4 @@
-"""Part of the UC presentation"""
+"""Part of the UC presentation. (Upgraded for CDP Mode.)"""
 import pytest
 from random import randint
 from seleniumbase import BaseCase
@@ -7,18 +7,11 @@
 
 @pytest.mark.parametrize("", [[]] * 3)
 def test_multi_threaded(sb):
-    url = "https://gitlab.com/users/sign_in"
-    sb.driver.uc_open_with_reconnect(url, 3)
-    sb.set_window_rect(randint(0, 755), randint(38, 403), 700, 500)
-    try:
-        sb.assert_text("Username", '[for="user_login"]', timeout=3)
-        sb.post_message("SeleniumBase wasn't detected", duration=4)
-        sb._print("\n Success! Website did not detect Selenium! ")
-    except Exception:
-        sb.driver.uc_open_with_reconnect(url, 3)
-        try:
-            sb.assert_text("Username", '[for="user_login"]', timeout=3)
-            sb.post_message("SeleniumBase wasn't detected", duration=4)
-            sb._print("\n Success! Website did not detect Selenium! ")
-        except Exception:
-            sb.fail('Selenium was detected! Try using: "pytest --uc"')
+    sb.activate_cdp_mode()  # If not UC Mode, then 2nd browser
+    sb.set_window_rect(randint(4, 680), randint(8, 380), 840, 520)
+    sb.open("https://gitlab.com/users/sign_in")
+    sb.sleep(2)
+    sb.solve_captcha()
+    sb.assert_text("Username", '[for="user_login"]', timeout=3)
+    sb.post_message("SeleniumBase wasn't detected", duration=4)
+    sb._print("\n Success: SeleniumBase wasn't detected! ")
diff --git a/examples/raw_antibot_login.py b/examples/raw_antibot_login.py
@@ -1,4 +1,6 @@
-"""UC Mode has PyAutoGUI methods for CAPTCHA-bypass."""
+"""UC Mode has PyAutoGUI methods for stealthy actions.
+PyAutoGUI gets installed automatically if not already.
+This old UC Mode code is made obsolete by CDP Mode."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
@@ -7,7 +9,7 @@
     sb.uc_gui_write("\t" + "demo_user")
     sb.uc_gui_write("\t" + "secret_pass")
     sb.uc_gui_press_keys("\t" + " ")  # For Single-char keys
-    sb.sleep(1.5)
+    sb.sleep(1.4)
     sb.uc_gui_press_keys(["\t", "ENTER"])  # Multi-char keys
     sb.reconnect(1.8)
     sb.assert_text("Welcome!", "h1")
diff --git a/examples/raw_brotector_captcha.py b/examples/raw_brotector_captcha.py
@@ -1,9 +1,8 @@
-"""UC Mode has PyAutoGUI methods for CAPTCHA-bypass."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
-    url = "https://seleniumbase.io/apps/brotector"
-    sb.uc_open_with_disconnect(url, 2.2)
-    sb.uc_gui_press_key("\t")
-    sb.uc_gui_press_key(" ")
-    sb.reconnect(2.2)
+    sb.activate_cdp_mode()
+    sb.open("https://seleniumbase.io/apps/brotector")
+    sb.click("button span#mySpan")
+    sb.assert_text("SUCCESS", "label#pText")
+    sb.highlight("label#pText")
diff --git a/examples/raw_cdp_logging.py b/examples/raw_cdp_logging.py
@@ -1,3 +1,5 @@
+"""NOTE: This uses plain UC Mode, which was replaced by UC + CDP Mode.
+PyAutoGUI is installed automatically for uc_gui methods if not already."""
 from rich.pretty import pprint
 from seleniumbase import Driver
 
diff --git a/examples/raw_form_turnstile.py b/examples/raw_form_turnstile.py
@@ -1,8 +1,9 @@
+"""CDP Mode for bypassing bot-detection & CAPTCHAs."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
-    url = "seleniumbase.io/apps/form_turnstile"
-    sb.uc_open_with_reconnect(url, 1.1)
+    sb.activate_cdp_mode()
+    sb.open("seleniumbase.io/apps/form_turnstile")
     sb.press_keys("#name", "SeleniumBase")
     sb.press_keys("#email", "test@test.test")
     sb.press_keys("#phone", "1-555-555-5555")
@@ -12,8 +13,8 @@
     sb.click('span:contains("9:00 PM")')
     sb.highlight_click('input[value="AR"] + span')
     sb.click('input[value="cc"] + span')
-    sb.scroll_to('div[class*="cf-turnstile"]')
-    sb.uc_gui_handle_captcha()
+    sb.scroll_down(40)
+    sb.solve_captcha()
     sb.highlight("img#captcha-success", timeout=3)
     sb.highlight_click('button:contains("Request & Pay")')
     sb.highlight("img#submit-success")
diff --git a/examples/raw_gui_click.py b/examples/raw_gui_click.py
@@ -1,8 +1,11 @@
+"""CDP Mode for bypassing bot-detection & CAPTCHAs.
+Note: sb.uc_gui_click_captcha() requires PyAutoGUI,
+which is installed automatically if not already."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
-    url = "seleniumbase.io/apps/form_turnstile"
-    sb.activate_cdp_mode(url)
+    sb.activate_cdp_mode()
+    sb.open("seleniumbase.io/apps/form_turnstile")
     sb.press_keys("#name", "SeleniumBase")
     sb.press_keys("#email", "test@test.test")
     sb.press_keys("#phone", "1-555-555-5555")
@@ -14,7 +17,7 @@
     sb.click('input[value="cc"] + span')
     sb.scroll_to('div[class*="cf-turnstile"]')
     sb.scroll_down(40)
-    sb.uc_gui_click_captcha()
+    sb.uc_gui_click_captcha()  # PyAutoGUI mouse click
     sb.highlight("img#captcha-success", timeout=3)
     sb.highlight_click('button:contains("Request & Pay")')
     sb.highlight("img#submit-success")
diff --git a/examples/raw_hobbit.py b/examples/raw_hobbit.py
@@ -1,11 +1,9 @@
-"""UC Mode has PyAutoGUI methods for CAPTCHA-bypass."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
-    url = "https://seleniumbase.io/hobbit/login"
-    sb.uc_open_with_disconnect(url, 2.2)
-    sb.uc_gui_press_keys("\t ")
-    sb.reconnect(1.5)
+    sb.activate_cdp_mode()
+    sb.open("https://seleniumbase.io/hobbit/login")
+    sb.click("button span#mySpan")
     sb.assert_text("Welcome to Middle Earth!", "h1")
     sb.set_messenger_theme(location="bottom_center")
     sb.post_message("SeleniumBase wasn't detected!")
diff --git a/examples/raw_uc_events.py b/examples/raw_uc_events.py
@@ -1,3 +1,5 @@
+"""NOTE: This uses plain UC Mode, which was replaced by UC + CDP Mode.
+PyAutoGUI is installed automatically for uc_gui methods if not already."""
 from rich.pretty import pprint
 from seleniumbase import SB
 
diff --git a/examples/raw_uc_mode.py b/examples/raw_uc_mode.py
@@ -1,4 +1,7 @@
-"""SB Manager using UC Mode for evading bot-detection."""
+"""SB Manager using UC Mode for evading bot-detection.
+Note that plain UC Mode was replaced by the newer CDP Mode:
+Instead of uc_open_with_reconnect, use activate_cdp_mode().
+Instead of uc_gui_click_captcha(), use solve_captcha()."""
 from seleniumbase import SB
 
 with SB(uc=True, test=True) as sb:
diff --git a/examples/uc_cdp_events.py b/examples/uc_cdp_events.py
@@ -1,3 +1,5 @@
+"""NOTE: This uses plain UC Mode, which was replaced by UC + CDP Mode.
+PyAutoGUI is installed automatically for uc_gui methods if not already."""
 from rich.pretty import pprint
 from seleniumbase import BaseCase
 BaseCase.main(__name__, __file__, "--uc", "--uc-cdp")
diff --git a/examples/verify_undetected.py b/examples/verify_undetected.py
@@ -1,17 +1,16 @@
-"""Determine if your browser is detectable by anti-bot services.
-Some sites use scripts to detect Selenium, and then block you.
-To evade detection, add --uc as a pytest command-line option."""
+"""Verify if your browser is detectable by anti-bot services.
+To evade detection, add --uc as a pytest command-line option.
+UC + CDP Mode is used: CDP Mode is activated from UC Mode."""
 from seleniumbase import BaseCase
 BaseCase.main(__name__, __file__, "--uc")
 
 
 class UndetectedTest(BaseCase):
     def test_browser_is_undetected(self):
-        url = "https://gitlab.com/users/sign_in"
-        if not self.undetectable:
-            self.get_new_driver(undetectable=True)
-        self.uc_open_with_reconnect(url)
-        self.uc_gui_click_captcha()
+        self.activate_cdp_mode()  # If not UC Mode, then 2nd browser
+        self.open("https://gitlab.com/users/sign_in")
+        self.sleep(2)
+        self.solve_captcha()  # (Only runs when a CAPTCHA is visible)
         self.assert_text("Username", '[for="user_login"]', timeout=3)
         self.post_message("SeleniumBase wasn't detected", duration=4)
-        self._print("\n Success! Website did not detect Selenium! ")
+        self._print("\n Success: SeleniumBase wasn't detected! ")

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,5 @@`
	`1`	`+"""Test mobile emulation via mycdp.emulation.set_device_metrics_override().`
	`2`	`+tab.send() is a stealthy version of Selenium's execute_cdp_cmd() method."""`
`1`	`3`	`import mycdp`
`2`	`4`	`from seleniumbase import SB`
`3`	`5`