Refactor code, examples, and docs

Author: mdmintz

README.md

@@ -66,7 +66,7 @@
 from seleniumbase import sb_cdp
 
 sb = sb_cdp.Chrome()
-sb.open("https://browserscan.net/bot-detection")
+sb.goto("https://browserscan.net/bot-detection")
 sb.sleep(3)
 sb.quit()
 ```
@@ -105,7 +105,7 @@ with sync_playwright() as p:
 from seleniumbase import sb_cdp
 
 sb = sb_cdp.Chrome(locale="en", ad_block=True)
-sb.open("https://browserscan.net/bot-detection")
+sb.goto("https://browserscan.net/bot-detection")
 sb.flash("Test Results", duration=1.5, pause=0.5)
 sb.assert_element('strong:contains("Normal")')
 print("Bot Not Detected")
@@ -242,7 +242,7 @@ BaseCase.main(__name__, __file__)  # Call pytest
 
 class MyTestClass(BaseCase):
     def test_swag_labs(self):
-        self.open("https://www.saucedemo.com")
+        self.goto("https://www.saucedemo.com")
         self.type("#user-name", "standard_user")
         self.type("#password", "secret_sauce\n")
         self.assert_element("div.inventory_list")
@@ -362,7 +362,7 @@ BaseCase.main(__name__, __file__)
 
 class TestSimpleLogin(BaseCase):
     def test_simple_login(self):
-        self.open("seleniumbase.io/simple/login")
+        self.goto("seleniumbase.io/simple/login")
         self.type("#username", "demo_user")
         self.type("#password", "secret_pass")
         self.click('a:contains("Sign in")')
@@ -379,7 +379,7 @@ class TestSimpleLogin(BaseCase):
 from seleniumbase import SB
 
 with SB() as sb:
-    sb.open("seleniumbase.io/simple/login")
+    sb.goto("seleniumbase.io/simple/login")
     sb.type("#username", "demo_user")
     sb.type("#password", "secret_pass")
     sb.click('a:contains("Sign in")')
@@ -397,7 +397,7 @@ from seleniumbase import Driver
 
 driver = Driver()
 try:
-    driver.open("seleniumbase.io/simple/login")
+    driver.goto("seleniumbase.io/simple/login")
     driver.type("#username", "demo_user")
     driver.type("#password", "secret_pass")
     driver.click('a:contains("Sign in")')
@@ -549,7 +549,7 @@ BaseCase.main(__name__, __file__)
 
 class MyTestClass(BaseCase):
     def test_swag_labs(self):
-        self.open("https://www.saucedemo.com")
+        self.goto("https://www.saucedemo.com")
         self.type("#user-name", "standard_user")
         self.type("#password", "secret_sauce\n")
         self.assert_element("div.inventory_list")
@@ -582,7 +582,8 @@ class MyTestClass(BaseCase):
 <h3><img src="https://seleniumbase.github.io/img/logo7.png" title="SeleniumBase" width="32" /> Here are some common SeleniumBase methods:</h3>
 
 ```python
-self.open(url)  # Navigate the browser window to the URL.
+self.goto(url)  # Navigate the browser window to the URL.
+self.open(url)  # Same as `self.goto(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.
@@ -958,7 +959,7 @@ BaseCase.main(__name__, __file__)
 class MyTestClass(BaseCase):
 
     def test_find_army_of_robots_on_xkcd_desert_island(self):
-        self.open("https://xkcd.com/731/")
+        self.goto("https://xkcd.com/731/")
         self.assert_element("div#ARMY_OF_ROBOTS", timeout=1)  # This should fail
 ```
 
@@ -1162,7 +1163,7 @@ pytest [YOUR_TEST_FILE.py] --with-db-reporting --with-s3-logging
 🔵 **Navigating to a web page: (and related commands)**
 
 ```python
-self.open("https://xkcd.com/378/")  # This method opens the specified page.
+self.goto("https://xkcd.com/378/")  # This method opens the specified page.
 
 self.go_back()  # This method navigates the browser to the previous page.
 
@@ -1299,7 +1300,7 @@ def is_there_a_cloaked_klingon_ship_on_this_page():
 
 ```python
 if self.is_text_visible("You Shall Not Pass!", "h1"):
-    self.open("https://www.youtube.com/watch?v=3xYXUeSmb-Y")
+    self.goto("https://www.youtube.com/watch?v=3xYXUeSmb-Y")
 ```
 
 <div></div>
@@ -1444,7 +1445,7 @@ self.execute_script("return jQuery('textarea')[2].value")  # Returns the css "va
 ```python
 start_page = "https://xkcd.com/465/"
 destination_page = "https://github.com/seleniumbase/SeleniumBase"
-self.open(start_page)
+self.goto(start_page)
 referral_link = '''<a class='analytics test' href='%s'>Free-Referral Button!</a>''' % destination_page
 self.execute_script('''document.body.innerHTML = \"%s\"''' % referral_link)
 self.click("a.analytics")  # Clicks the generated button
@@ -1464,7 +1465,7 @@ BaseCase.main(__name__, __file__)
 
 class DeferredAssertTests(BaseCase):
     def test_deferred_asserts(self):
-        self.open("https://xkcd.com/993/")
+        self.goto("https://xkcd.com/993/")
         self.wait_for_element("#comic")
         self.deferred_assert_element('img[alt="Brand Identity"]')
         self.deferred_assert_element('img[alt="Rocket Ship"]')  # Will Fail

examples/basic_test.py

@@ -5,7 +5,7 @@
 
 class MyTestClass(BaseCase):
     def test_basics(self):
-        self.open("https://www.saucedemo.com")
+        self.goto("https://www.saucedemo.com")
         self.type("#user-name", "standard_user")
         self.type("#password", "secret_sauce\n")
         self.assert_element("div.inventory_list")

examples/behave_bdd/ReadMe.md

@@ -121,7 +121,7 @@ from behave import step
 @step("Open the Swag Labs Login Page")
 def go_to_swag_labs(context):
     sb = context.sb
-    sb.open("https://www.saucedemo.com")
+    sb.goto("https://www.saucedemo.com")
     sb.clear_local_storage()
 
 

examples/behave_bdd/features/steps/calculator.py

@@ -3,7 +3,7 @@
 
 @step("Open the Calculator App")
 def go_to_calculator(context):
-    context.sb.open("https://seleniumbase.io/apps/calculator")
+    context.sb.goto("https://seleniumbase.io/apps/calculator")
 
 
 @step("Press C")

examples/behave_bdd/features/steps/fail_page.py

@@ -3,7 +3,7 @@
 
 @step("Open the Fail Page")
 def go_to_error_page(context):
-    context.sb.open("https://seleniumbase.io/error_page/")
+    context.sb.goto("https://seleniumbase.io/error_page/")
 
 
 @step("Fail test on purpose")

examples/behave_bdd/features/steps/swag_labs.py

@@ -4,7 +4,7 @@
 @step("Open the Swag Labs Login Page")
 def go_to_swag_labs(context):
     sb = context.sb
-    sb.open("https://www.saucedemo.com")
+    sb.goto("https://www.saucedemo.com")
     sb.clear_local_storage()
 
 

examples/boilerplates/classic_obj_test.py

@@ -5,7 +5,7 @@
 
 class DataPage:
     def go_to_data_url(self, sb):
-        sb.open("data:text/html,<p>Hello!</p><input />")
+        sb.goto("data:text/html,<p>Hello!</p><input />")
 
     def add_input_text(self, sb, text):
         sb.type("input", text)

examples/boilerplates/samples/google_test.py

@@ -10,18 +10,19 @@
 class GoogleTests(BaseCase):
     def test_google_dot_com(self):
         if self.headless:
-            self.open_if_not_url("about:blank")
+            self.goto_if_not_url("about:blank")
             print("\n  Skipping test in headless mode.")
             self.skip("Skipping test in headless mode.")
         if not self.undetectable:
             self.get_new_driver(undetectable=True)
-        self.driver.get("https://google.com/ncr")
+        self.goto("https://google.com/ncr")
         self.click_if_visible('button:contains("Accept all")')
         self.assert_title_contains("Google")
         self.sleep(0.05)
         self.save_screenshot_to_logs()  # ("./latest_logs" folder)
-        self.type(HomePage.search_box, "github.com")
+        self.type(HomePage.search_box, "GitHub")
         self.assert_element(HomePage.search_button)
         self.assert_element(HomePage.feeling_lucky_button)
         self.click(HomePage.search_button)
+        self.sleep(1)
         self.assert_text("github.com", ResultsPage.search_results)

examples/boilerplates/samples/sb_swag_test.py

@@ -5,7 +5,7 @@
 
 class LoginPage:
     def login_to_swag_labs(self, sb: BaseCase, username):
-        sb.open("https://www.saucedemo.com")
+        sb.goto("https://www.saucedemo.com")
         sb.type("#user-name", username)
         sb.type("#password", "secret_sauce")
         sb.click('input[type="submit"]')

examples/boilerplates/samples/swag_labs_test.py

@@ -5,7 +5,7 @@
 
 class LoginPage:
     def login_to_swag_labs(self, sb: BaseCase, username):
-        sb.open("https://www.saucedemo.com")
+        sb.goto("https://www.saucedemo.com")
         sb.type("#user-name", username)
         sb.type("#password", "secret_sauce")
         sb.click('input[type="submit"]')