From 00ef684bde24bbc0c526c63bb14bb6ebf41df2b7 Mon Sep 17 00:00:00 2001
From: Michael Mintz <mdmintz@gmail.com>
Date: Thu, 18 Feb 2021 23:31:51 -0500
Subject: [PATCH] Improve the error output for incorrect usage of page objects

---
 seleniumbase/common/exceptions.py  |   5 +
 seleniumbase/fixtures/base_case.py | 208 +++++++++++++++++++++++++++++
 2 files changed, 213 insertions(+)

diff --git a/seleniumbase/common/exceptions.py b/seleniumbase/common/exceptions.py
index dc1edc8c..60b8aed0 100755
--- a/seleniumbase/common/exceptions.py
+++ b/seleniumbase/common/exceptions.py
@@ -1,5 +1,6 @@
 """ SeleniumBase Exceptions
     NoSuchFileException => Used by self.assert_downloaded_file(...)
+    OutOfScopeException => Used by BaseCase methods when setUp() is skipped
     TimeLimitExceededException => Used by "--time-limit=SECONDS"
 """
 
@@ -8,5 +9,9 @@ class NoSuchFileException(Exception):
     pass
 
 
+class OutOfScopeException(Exception):
+    pass
+
+
 class TimeLimitExceededException(Exception):
     pass
diff --git a/seleniumbase/fixtures/base_case.py b/seleniumbase/fixtures/base_case.py
index 7ee807e1..4dd96c6b 100755
--- a/seleniumbase/fixtures/base_case.py
+++ b/seleniumbase/fixtures/base_case.py
@@ -99,6 +99,7 @@ class BaseCase(unittest.TestCase):
 
     def open(self, url):
         """ Navigates the current browser window to the specified page. """
+        self.__check_scope()
         if type(url) is str:
             url = url.strip()  # Remove leading and trailing whitespace
         if (type(url) is not str) or not self.__looks_like_a_page_url(url):
@@ -124,12 +125,14 @@ class BaseCase(unittest.TestCase):
                 self.get("https://seleniumbase.io")  # Navigates to the URL
                 self.get("input.class")  # Finds and returns the WebElement
         """
+        self.__check_scope()
         if self.__looks_like_a_page_url(url):
             self.open(url)
         else:
             return self.get_element(url)  # url is treated like a selector
 
     def click(self, selector, by=By.CSS_SELECTOR, timeout=None, delay=0):
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -210,6 +213,7 @@ class BaseCase(unittest.TestCase):
             To set the user-agent, use: ``--agent=AGENT``.
             Here's an example message from GitHub's bot-blocker:
             ``You have triggered an abuse detection mechanism...`` """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -224,6 +228,7 @@ class BaseCase(unittest.TestCase):
 
     def double_click(self, selector, by=By.CSS_SELECTOR, timeout=None):
         from selenium.webdriver.common.action_chains import ActionChains
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -276,6 +281,7 @@ class BaseCase(unittest.TestCase):
                     timeout=None, spacing=0):
         """ This method clicks on a list of elements in succession.
             'spacing' is the amount of time to wait between clicks. (sec) """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -301,6 +307,7 @@ class BaseCase(unittest.TestCase):
             timeout - how long to wait for the selector to be visible
             retry - if True, use JS if the Selenium text update fails
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -371,6 +378,7 @@ class BaseCase(unittest.TestCase):
     def add_text(self, selector, text, by=By.CSS_SELECTOR, timeout=None):
         """ The more-reliable version of driver.send_keys()
             Similar to update_text(), but won't clear the text field first. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -433,6 +441,7 @@ class BaseCase(unittest.TestCase):
             retry - if True, use JS if the Selenium text update fails
             DO NOT confuse self.type() with Python type()! They are different!
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -442,6 +451,7 @@ class BaseCase(unittest.TestCase):
 
     def submit(self, selector, by=By.CSS_SELECTOR):
         """ Alternative to self.driver.find_element_by_*(SELECTOR).submit() """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         element = self.wait_for_element_visible(
             selector, by=by, timeout=settings.SMALL_TIMEOUT)
@@ -462,6 +472,7 @@ class BaseCase(unittest.TestCase):
             by - the type of selector to search by (Default: CSS Selector)
             timeout - how long to wait for the selector to be visible
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -489,6 +500,7 @@ class BaseCase(unittest.TestCase):
             element.clear()
 
     def refresh_page(self):
+        self.__check_scope()
         self.__last_page_load_url = None
         js_utils.clear_out_console_logs(self.driver)
         self.driver.refresh()
@@ -499,6 +511,7 @@ class BaseCase(unittest.TestCase):
         self.refresh_page()
 
     def get_current_url(self):
+        self.__check_scope()
         current_url = self.driver.current_url
         if "%" in current_url and sys.version_info[0] >= 3:
             try:
@@ -523,15 +536,18 @@ class BaseCase(unittest.TestCase):
         return self.get_page_title()
 
     def get_user_agent(self):
+        self.__check_scope()
         user_agent = self.driver.execute_script("return navigator.userAgent;")
         return user_agent
 
     def get_locale_code(self):
+        self.__check_scope()
         locale_code = self.driver.execute_script(
             "return navigator.language || navigator.languages[0];")
         return locale_code
 
     def go_back(self):
+        self.__check_scope()
         self.__last_page_load_url = None
         if self.browser != "safari":
             self.driver.back()
@@ -543,6 +559,7 @@ class BaseCase(unittest.TestCase):
         self.__demo_mode_pause_if_active()
 
     def go_forward(self):
+        self.__check_scope()
         self.__last_page_load_url = None
         if self.browser != "safari":
             self.driver.forward()
@@ -554,10 +571,12 @@ class BaseCase(unittest.TestCase):
         self.__demo_mode_pause_if_active()
 
     def is_element_present(self, selector, by=By.CSS_SELECTOR):
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         return page_actions.is_element_present(self.driver, selector, by)
 
     def is_element_visible(self, selector, by=By.CSS_SELECTOR):
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         return page_actions.is_element_visible(self.driver, selector, by)
 
@@ -583,6 +602,7 @@ class BaseCase(unittest.TestCase):
         """ Returns True if the link text appears in the HTML of the page.
             The element doesn't need to be visible,
             such as elements hidden inside a dropdown selection. """
+        self.__check_scope()
         soup = self.get_beautiful_soup()
         html_links = soup.find_all('a')
         for html_link in html_links:
@@ -594,6 +614,7 @@ class BaseCase(unittest.TestCase):
         """ Returns True if the partial link appears in the HTML of the page.
             The element doesn't need to be visible,
             such as elements hidden inside a dropdown selection. """
+        self.__check_scope()
         soup = self.get_beautiful_soup()
         html_links = soup.find_all('a')
         for html_link in html_links:
@@ -605,6 +626,7 @@ class BaseCase(unittest.TestCase):
         """ Finds a link by link text and then returns the attribute's value.
             If the link text or attribute cannot be found, an exception will
             get raised if hard_fail is True (otherwise None is returned). """
+        self.__check_scope()
         soup = self.get_beautiful_soup()
         html_links = soup.find_all('a')
         for html_link in html_links:
@@ -636,6 +658,7 @@ class BaseCase(unittest.TestCase):
             value. If the partial link text or attribute cannot be found, an
             exception will get raised if hard_fail is True (otherwise None
             is returned). """
+        self.__check_scope()
         soup = self.get_beautiful_soup()
         html_links = soup.find_all('a')
         for html_link in html_links:
@@ -659,6 +682,7 @@ class BaseCase(unittest.TestCase):
     def click_link_text(self, link_text, timeout=None):
         """ This method clicks link text on a page """
         # If using phantomjs, might need to extract and open the link directly
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -760,6 +784,7 @@ class BaseCase(unittest.TestCase):
     def click_partial_link_text(self, partial_link_text, timeout=None):
         """ This method clicks the partial link text on a page. """
         # If using phantomjs, might need to extract and open the link directly
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -864,6 +889,7 @@ class BaseCase(unittest.TestCase):
             self.__slow_mode_pause_if_active()
 
     def get_text(self, selector, by=By.CSS_SELECTOR, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -886,6 +912,7 @@ class BaseCase(unittest.TestCase):
     def get_attribute(self, selector, attribute, by=By.CSS_SELECTOR,
                       timeout=None, hard_fail=True):
         """ This method uses JavaScript to get the value of an attribute. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -916,6 +943,7 @@ class BaseCase(unittest.TestCase):
                       timeout=None):
         """ This method uses JavaScript to set/update an attribute.
             Only the first matching selector from querySelector() is used. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -942,6 +970,7 @@ class BaseCase(unittest.TestCase):
             All matching selectors from querySelectorAll() are used.
             Example => (Make all links on a website redirect to Google):
             self.set_attributes("a", "href", "https://google.com") """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         attribute = re.escape(attribute)
         attribute = self.__escape_quotes_if_needed(attribute)
@@ -973,6 +1002,7 @@ class BaseCase(unittest.TestCase):
                          timeout=None):
         """ This method uses JavaScript to remove an attribute.
             Only the first matching selector from querySelector() is used. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -995,6 +1025,7 @@ class BaseCase(unittest.TestCase):
     def remove_attributes(self, selector, attribute, by=By.CSS_SELECTOR):
         """ This method uses JavaScript to remove a common attribute.
             All matching selectors from querySelectorAll() are used. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         attribute = re.escape(attribute)
         attribute = self.__escape_quotes_if_needed(attribute)
@@ -1017,6 +1048,7 @@ class BaseCase(unittest.TestCase):
             Example:
                 opacity = self.get_property_value("html body a", "opacity")
                 self.assertTrue(float(opacity) > 0, "Element not visible!") """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1046,6 +1078,7 @@ class BaseCase(unittest.TestCase):
 
     def get_image_url(self, selector, by=By.CSS_SELECTOR, timeout=None):
         """ Extracts the URL from an image element on the page. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1085,6 +1118,7 @@ class BaseCase(unittest.TestCase):
             Also clicks elements that become visible from previous clicks.
             Works best for actions such as clicking all checkboxes on a page.
             Example:  self.click_visible_elements('input[type="checkbox"]') """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1144,6 +1178,7 @@ class BaseCase(unittest.TestCase):
         """ 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.) """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1182,6 +1217,7 @@ class BaseCase(unittest.TestCase):
             Returns False if the element is not checked.
             If the element is not present on the page, raises an exception.
             If the element is not a checkbox or radio, raises an exception. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1203,6 +1239,7 @@ class BaseCase(unittest.TestCase):
 
     def check_if_unchecked(self, selector, by=By.CSS_SELECTOR):
         """ If a checkbox or radio button is not checked, will check it. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         if not self.is_checked(selector, by=by):
             if self.is_element_visible(selector, by=by):
@@ -1217,6 +1254,7 @@ class BaseCase(unittest.TestCase):
 
     def uncheck_if_checked(self, selector, by=By.CSS_SELECTOR):
         """ If a checkbox is checked, will uncheck it. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         if self.is_checked(selector, by=by):
             if self.is_element_visible(selector, by=by):
@@ -1232,6 +1270,7 @@ class BaseCase(unittest.TestCase):
     def is_element_in_an_iframe(self, selector, by=By.CSS_SELECTOR):
         """ Returns True if the selector's element is located in an iframe.
             Otherwise returns False. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         if self.is_element_present(selector, by=by):
             return False
@@ -1260,6 +1299,7 @@ class BaseCase(unittest.TestCase):
             element is in a single-nested iframe) and returns the iframe name.
             If element is not in an iframe, returns None, and nothing happens.
             May not work if multiple iframes are nested within each other. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         if self.is_element_present(selector, by=by):
             return None
@@ -1293,6 +1333,7 @@ class BaseCase(unittest.TestCase):
                             "element {%s}!" % selector)
 
     def hover_on_element(self, selector, by=By.CSS_SELECTOR):
+        self.__check_scope()
         original_selector = selector
         original_by = by
         selector, by = self.__recalculate_selector(selector, by)
@@ -1341,6 +1382,7 @@ class BaseCase(unittest.TestCase):
                         timeout=None):
         """ When you want to hover over an element or dropdown menu,
             and then click an element that appears after that. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1404,6 +1446,7 @@ class BaseCase(unittest.TestCase):
                                timeout=None):
         """ When you want to hover over an element or dropdown menu,
             and then double-click an element that appears after that. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1454,6 +1497,7 @@ class BaseCase(unittest.TestCase):
                       drag_by=By.CSS_SELECTOR, drop_by=By.CSS_SELECTOR,
                       timeout=None):
         """ Drag and drop an element from one selector to another. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1488,6 +1532,7 @@ class BaseCase(unittest.TestCase):
     def drag_and_drop_with_offset(
             self, selector, x, y, by=By.CSS_SELECTOR, timeout=None):
         """ Drag and drop an element to an {X,Y}-offset location. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1514,6 +1559,7 @@ class BaseCase(unittest.TestCase):
             Option specifications are by "text", "index", or "value".
             Defaults to "text" if option_by is unspecified or unknown. """
         from selenium.webdriver.support.ui import Select
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1562,6 +1608,7 @@ class BaseCase(unittest.TestCase):
             @Params
             dropdown_selector - the <select> selector
             option - the text of the option """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1577,6 +1624,7 @@ class BaseCase(unittest.TestCase):
             @Params
             dropdown_selector - the <select> selector
             option - the index number of the option """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1592,6 +1640,7 @@ class BaseCase(unittest.TestCase):
             @Params
             dropdown_selector - the <select> selector
             option - the value property of the option """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1605,6 +1654,7 @@ class BaseCase(unittest.TestCase):
             If new_page==True, the page will switch to: "data:text/html,"
             If new_page==False, will load HTML into the current page. """
 
+        self.__check_scope()
         soup = self.get_beautiful_soup(html_string)
         found_base = False
         links = soup.findAll("link")
@@ -1701,6 +1751,7 @@ class BaseCase(unittest.TestCase):
             If new_page==True, the page will switch to: "data:text/html,"
             If new_page==False, will load HTML into the current page.
             Local images and other local src content WILL BE IGNORED. """
+        self.__check_scope()
         if self.__looks_like_a_page_url(html_file):
             self.open(html_file)
             return
@@ -1720,6 +1771,7 @@ class BaseCase(unittest.TestCase):
     def open_html_file(self, html_file):
         """ Opens a local html file into the browser from a relative file path.
             The URL displayed in the web browser will start with "file://". """
+        self.__check_scope()
         if self.__looks_like_a_page_url(html_file):
             self.open(html_file)
             return
@@ -1734,9 +1786,11 @@ class BaseCase(unittest.TestCase):
         self.open("file://" + file_path)
 
     def execute_script(self, script):
+        self.__check_scope()
         return self.driver.execute_script(script)
 
     def execute_async_script(self, script, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.EXTREME_TIMEOUT
         return js_utils.execute_async_script(self.driver, script, timeout)
@@ -1745,6 +1799,7 @@ class BaseCase(unittest.TestCase):
         """ When executing a script that contains a jQuery command,
             it's important that the jQuery library has been loaded first.
             This method will load jQuery if it wasn't already loaded. """
+        self.__check_scope()
         try:
             return self.execute_script(script)
         except Exception:
@@ -1753,14 +1808,17 @@ class BaseCase(unittest.TestCase):
             return self.execute_script(script)
 
     def set_window_rect(self, x, y, width, height):
+        self.__check_scope()
         self.driver.set_window_rect(x, y, width, height)
         self.__demo_mode_pause_if_active()
 
     def set_window_size(self, width, height):
+        self.__check_scope()
         self.driver.set_window_size(width, height)
         self.__demo_mode_pause_if_active()
 
     def maximize_window(self):
+        self.__check_scope()
         self.driver.maximize_window()
         self.__demo_mode_pause_if_active()
 
@@ -1775,6 +1833,7 @@ class BaseCase(unittest.TestCase):
         frame - the frame element, name, id, index, or selector
         timeout - the time to wait for the alert in seconds
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1791,16 +1850,19 @@ class BaseCase(unittest.TestCase):
             (If driver control is inside an iframe, the driver control
             will be set to one level above the current frame. If the driver
             control is not currently in an iframe, nothing will happen.) """
+        self.__check_scope()
         self.driver.switch_to.default_content()
 
     def open_new_window(self, switch_to=True):
         """ Opens a new browser tab/window and switches to it by default. """
+        self.__check_scope()
         self.driver.execute_script("window.open('');")
         time.sleep(0.01)
         if switch_to:
             self.switch_to_window(len(self.driver.window_handles) - 1)
 
     def switch_to_window(self, window, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -1854,6 +1916,7 @@ class BaseCase(unittest.TestCase):
             d_height - the device height of the mobile emulator (Chrome-only)
             d_p_r - the device pixel ratio of the mobile emulator (Chrome-only)
         """
+        self.__check_scope()
         if self.browser == "remote" and self.servername == "localhost":
             raise Exception('Cannot use "remote" browser driver on localhost!'
                             ' Did you mean to connect to a remote Grid server'
@@ -2054,10 +2117,12 @@ class BaseCase(unittest.TestCase):
 
     def switch_to_default_driver(self):
         """ Sets self.driver to the default/original driver. """
+        self.__check_scope()
         self.driver = self._default_driver
 
     def save_screenshot(self, name, folder=None):
         """ The screenshot will be in PNG format. """
+        self.__check_scope()
         return page_actions.save_screenshot(self.driver, name, folder)
 
     def save_page_source(self, name, folder=None):
@@ -2067,10 +2132,12 @@ class BaseCase(unittest.TestCase):
             name - The file name to save the current page's HTML to.
             folder - The folder to save the file to. (Default = current folder)
         """
+        self.__check_scope()
         return page_actions.save_page_source(self.driver, name, folder)
 
     def save_cookies(self, name="cookies.txt"):
         """ Saves the page cookies to the "saved_cookies" folder. """
+        self.__check_scope()
         cookies = self.driver.get_cookies()
         json_cookies = json.dumps(cookies)
         if name.endswith('/'):
@@ -2093,6 +2160,7 @@ class BaseCase(unittest.TestCase):
 
     def load_cookies(self, name="cookies.txt"):
         """ Loads the page cookies from the "saved_cookies" folder. """
+        self.__check_scope()
         if name.endswith('/'):
             raise Exception("Invalid filename for Cookies!")
         if '/' in name:
@@ -2117,11 +2185,13 @@ class BaseCase(unittest.TestCase):
     def delete_all_cookies(self):
         """ Deletes all cookies in the web browser.
             Does NOT delete the saved cookies file. """
+        self.__check_scope()
         self.driver.delete_all_cookies()
 
     def delete_saved_cookies(self, name="cookies.txt"):
         """ Deletes the cookies file from the "saved_cookies" folder.
             Does NOT delete the cookies from the web browser. """
+        self.__check_scope()
         if name.endswith('/'):
             raise Exception("Invalid filename for Cookies!")
         if '/' in name:
@@ -2139,6 +2209,7 @@ class BaseCase(unittest.TestCase):
                 os.remove(cookies_file_path)
 
     def wait_for_ready_state_complete(self, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.EXTREME_TIMEOUT
         if self.timeout_multiplier and timeout == settings.EXTREME_TIMEOUT:
@@ -2161,6 +2232,7 @@ class BaseCase(unittest.TestCase):
         return is_ready
 
     def wait_for_angularjs(self, timeout=None, **kwargs):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -2168,6 +2240,7 @@ class BaseCase(unittest.TestCase):
         js_utils.wait_for_angularjs(self.driver, timeout, **kwargs)
 
     def sleep(self, seconds):
+        self.__check_scope()
         if not sb_config.time_limit:
             time.sleep(seconds)
         elif seconds <= 0.3:
@@ -2188,6 +2261,7 @@ class BaseCase(unittest.TestCase):
         """ Installs a Firefox add-on instantly at run-time.
             @Params
             xpi_file - A file archive in .xpi format. """
+        self.__check_scope()
         if self.browser != "firefox":
             raise Exception(
                 "install_addon(xpi_file) is for Firefox ONLY!\n"
@@ -2199,17 +2273,20 @@ class BaseCase(unittest.TestCase):
     def activate_design_mode(self):
         # Activate Chrome's Design Mode, which lets you edit a site directly.
         # See: https://twitter.com/sulco/status/1177559150563344384
+        self.__check_scope()
         script = ("""document.designMode = 'on';""")
         self.execute_script(script)
 
     def deactivate_design_mode(self):
         # Deactivate Chrome's Design Mode.
+        self.__check_scope()
         script = ("""document.designMode = 'off';""")
         self.execute_script(script)
 
     def activate_jquery(self):
         """ If "jQuery is not defined", use this method to activate it for use.
             This happens because jQuery is not always defined on web sites. """
+        self.__check_scope()
         js_utils.activate_jquery(self.driver)
         self.wait_for_ready_state_complete()
 
@@ -2224,6 +2301,7 @@ class BaseCase(unittest.TestCase):
             Useful when getting a WebDriverException, such as the one below:
                 { Element is not clickable at point (#, #).
                   Other element would receive the click: ... } """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         self.wait_for_element_visible(
             selector, by=by, timeout=settings.SMALL_TIMEOUT)
@@ -2240,12 +2318,14 @@ class BaseCase(unittest.TestCase):
 
     def highlight_click(self, selector, by=By.CSS_SELECTOR,
                         loops=3, scroll=True):
+        self.__check_scope()
         if not self.demo_mode:
             self.highlight(selector, by=by, loops=loops, scroll=scroll)
         self.click(selector, by=by)
 
     def highlight_update_text(self, selector, text, by=By.CSS_SELECTOR,
                               loops=3, scroll=True):
+        self.__check_scope()
         if not self.demo_mode:
             self.highlight(selector, by=by, loops=loops, scroll=scroll)
         self.update_text(selector, text, by=by)
@@ -2261,6 +2341,7 @@ class BaseCase(unittest.TestCase):
                     (Default: 4. Each loop lasts for about 0.18s)
             scroll - the option to scroll to the element first (Default: True)
         """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by, xp_ok=False)
         element = self.wait_for_element_visible(
             selector, by=by, timeout=settings.SMALL_TIMEOUT)
@@ -2326,15 +2407,18 @@ class BaseCase(unittest.TestCase):
         time.sleep(0.065)
 
     def __highlight_with_js(self, selector, loops, o_bs):
+        self.__check_scope()
         js_utils.highlight_with_js(self.driver, selector, loops, o_bs)
 
     def __highlight_with_jquery(self, selector, loops, o_bs):
+        self.__check_scope()
         js_utils.highlight_with_jquery(self.driver, selector, loops, o_bs)
 
     def press_up_arrow(self, selector="html", times=1, by=By.CSS_SELECTOR):
         """ Simulates pressing the UP Arrow on the keyboard.
             By default, "html" will be used as the CSS Selector target.
             You can specify how many times in-a-row the action happens. """
+        self.__check_scope()
         if times < 1:
             return
         element = self.wait_for_element_present(selector)
@@ -2356,6 +2440,7 @@ class BaseCase(unittest.TestCase):
         """ Simulates pressing the DOWN Arrow on the keyboard.
             By default, "html" will be used as the CSS Selector target.
             You can specify how many times in-a-row the action happens. """
+        self.__check_scope()
         if times < 1:
             return
         element = self.wait_for_element_present(selector)
@@ -2377,6 +2462,7 @@ class BaseCase(unittest.TestCase):
         """ Simulates pressing the LEFT Arrow on the keyboard.
             By default, "html" will be used as the CSS Selector target.
             You can specify how many times in-a-row the action happens. """
+        self.__check_scope()
         if times < 1:
             return
         element = self.wait_for_element_present(selector)
@@ -2398,6 +2484,7 @@ class BaseCase(unittest.TestCase):
         """ Simulates pressing the RIGHT Arrow on the keyboard.
             By default, "html" will be used as the CSS Selector target.
             You can specify how many times in-a-row the action happens. """
+        self.__check_scope()
         if times < 1:
             return
         element = self.wait_for_element_present(selector)
@@ -2417,6 +2504,7 @@ class BaseCase(unittest.TestCase):
 
     def scroll_to(self, selector, by=By.CSS_SELECTOR, timeout=None):
         ''' Fast scroll to destination '''
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -2437,6 +2525,7 @@ class BaseCase(unittest.TestCase):
 
     def slow_scroll_to(self, selector, by=By.CSS_SELECTOR, timeout=None):
         ''' Slow motion scroll to destination '''
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -2460,6 +2549,7 @@ class BaseCase(unittest.TestCase):
 
     def scroll_to_top(self):
         """ Scroll to the top of the page. """
+        self.__check_scope()
         scroll_script = "window.scrollTo(0, 0);"
         try:
             self.execute_script(scroll_script)
@@ -2470,6 +2560,7 @@ class BaseCase(unittest.TestCase):
 
     def scroll_to_bottom(self):
         """ Scroll to the bottom of the page. """
+        self.__check_scope()
         scroll_script = "window.scrollTo(0, 10000);"
         try:
             self.execute_script(scroll_script)
@@ -2534,6 +2625,7 @@ class BaseCase(unittest.TestCase):
     def jquery_click(self, selector, by=By.CSS_SELECTOR):
         """ Clicks an element using jQuery. (Different from using pure JS.)
             Can be used to click hidden / invisible elements. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by, xp_ok=False)
         self.wait_for_element_present(
             selector, by=by, timeout=settings.SMALL_TIMEOUT)
@@ -2547,6 +2639,7 @@ class BaseCase(unittest.TestCase):
 
     def jquery_click_all(self, selector, by=By.CSS_SELECTOR):
         """ Clicks all matching elements using jQuery. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by, xp_ok=False)
         self.wait_for_element_present(
             selector, by=by, timeout=settings.SMALL_TIMEOUT)
@@ -2559,6 +2652,7 @@ class BaseCase(unittest.TestCase):
 
     def hide_element(self, selector, by=By.CSS_SELECTOR):
         """ Hide the first element on the page that matches the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         selector = self.__make_css_match_first_element_only(selector)
@@ -2567,6 +2661,7 @@ class BaseCase(unittest.TestCase):
 
     def hide_elements(self, selector, by=By.CSS_SELECTOR):
         """ Hide all elements on the page that match the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         hide_script = """jQuery('%s').hide();""" % selector
@@ -2574,6 +2669,7 @@ class BaseCase(unittest.TestCase):
 
     def show_element(self, selector, by=By.CSS_SELECTOR):
         """ Show the first element on the page that matches the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         selector = self.__make_css_match_first_element_only(selector)
@@ -2582,6 +2678,7 @@ class BaseCase(unittest.TestCase):
 
     def show_elements(self, selector, by=By.CSS_SELECTOR):
         """ Show all elements on the page that match the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         show_script = """jQuery('%s').show(0);""" % selector
@@ -2589,6 +2686,7 @@ class BaseCase(unittest.TestCase):
 
     def remove_element(self, selector, by=By.CSS_SELECTOR):
         """ Remove the first element on the page that matches the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         selector = self.__make_css_match_first_element_only(selector)
@@ -2597,6 +2695,7 @@ class BaseCase(unittest.TestCase):
 
     def remove_elements(self, selector, by=By.CSS_SELECTOR):
         """ Remove all elements on the page that match the selector. """
+        self.__check_scope()
         selector, by = self.__recalculate_selector(selector, by)
         selector = self.convert_to_css_selector(selector, by=by)
         remove_script = """jQuery('%s').remove();""" % selector
@@ -2605,6 +2704,7 @@ class BaseCase(unittest.TestCase):
     def ad_block(self):
         """ Block ads that appear on the current web page. """
         from seleniumbase.config import ad_block_list
+        self.__check_scope()
         for css_selector in ad_block_list.AD_BLOCK_LIST:
             css_selector = re.escape(css_selector)  # Add "\\" to special chars
             css_selector = self.__escape_quotes_if_needed(css_selector)
@@ -2619,6 +2719,7 @@ class BaseCase(unittest.TestCase):
                 pass  # Don't fail test if ad_blocking fails
 
     def get_domain_url(self, url):
+        self.__check_scope()
         return page_utils.get_domain_url(url)
 
     def get_beautiful_soup(self, source=None):
@@ -2856,6 +2957,7 @@ class BaseCase(unittest.TestCase):
             Example usage:
                 self.choose_file('input[type="file"]', "my_dir/my_file.txt")
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -2936,6 +3038,7 @@ class BaseCase(unittest.TestCase):
     def get_downloads_folder(self):
         """ Returns the OS path of the "downloads/" folder.
             Chromium Guest Mode overwrites the path set by SeleniumBase. """
+        self.__check_scope()
         sys_plat = sys.platform
         chromium = False
         if self.browser in ("chrome", "edge", "opera"):
@@ -2958,6 +3061,7 @@ class BaseCase(unittest.TestCase):
 
     def assert_downloaded_file(self, file, timeout=None):
         """ Asserts that the file exists in the Downloads Folder. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3060,6 +3164,7 @@ class BaseCase(unittest.TestCase):
                 * See https://github.com/SeleniumHQ/selenium/issues/1161
             Based on the following Stack Overflow solution:
                 * https://stackoverflow.com/a/41150512/7058266 """
+        self.__check_scope()
         time.sleep(0.1)  # May take a moment for errors to appear after loads.
         try:
             browser_logs = self.driver.get_log('browser')
@@ -3194,6 +3299,7 @@ class BaseCase(unittest.TestCase):
 
     def set_value(self, selector, text, by=By.CSS_SELECTOR, timeout=None):
         """ This method uses JavaScript to update a text field. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3235,6 +3341,7 @@ class BaseCase(unittest.TestCase):
             If text ends in "\n", set_value() presses RETURN after.
             Works faster than send_keys() alone due to the JS call.
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3260,6 +3367,7 @@ class BaseCase(unittest.TestCase):
             If text ends in "\n", set_value() presses RETURN after.
             Works faster than send_keys() alone due to the JS call.
         """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3283,6 +3391,7 @@ class BaseCase(unittest.TestCase):
             Performs self.set_value() and triggers event listeners.
             If text ends in "\n", set_value() presses RETURN after.
             Works faster than send_keys() alone due to the JS call. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3306,6 +3415,7 @@ class BaseCase(unittest.TestCase):
             If the text string ends with the newline character,
             Selenium finishes the call, which simulates pressing
             {Enter/Return} after the text is entered. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3328,6 +3438,7 @@ class BaseCase(unittest.TestCase):
         self.__demo_mode_pause_if_active()
 
     def set_time_limit(self, time_limit):
+        self.__check_scope()
         if time_limit:
             try:
                 sb_config.time_limit = float(time_limit)
@@ -3345,6 +3456,7 @@ class BaseCase(unittest.TestCase):
 
     def skip(self, reason=""):
         """ Mark the test as Skipped. """
+        self.__check_scope()
         if self.dashboard or (self.is_pytest and self.with_db_reporting):
             test_id = self.__get_test_id_2()
             sb_config._results[test_id] = "Skipped"
@@ -3359,21 +3471,26 @@ class BaseCase(unittest.TestCase):
     # Application "Local Storage" controls
 
     def set_local_storage_item(self, key, value):
+        self.__check_scope()
         self.execute_script(
             "window.localStorage.setItem('{}', '{}');".format(key, value))
 
     def get_local_storage_item(self, key):
+        self.__check_scope()
         return self.execute_script(
             "return window.localStorage.getItem('{}');".format(key))
 
     def remove_local_storage_item(self, key):
+        self.__check_scope()
         self.execute_script(
             "window.localStorage.removeItem('{}');".format(key))
 
     def clear_local_storage(self):
+        self.__check_scope()
         self.execute_script("window.localStorage.clear();")
 
     def get_local_storage_keys(self):
+        self.__check_scope()
         return self.execute_script(
             "var ls = window.localStorage, keys = []; "
             "for (var i = 0; i < ls.length; ++i) "
@@ -3381,6 +3498,7 @@ class BaseCase(unittest.TestCase):
             "return keys;")
 
     def get_local_storage_items(self):
+        self.__check_scope()
         return self.execute_script(
             r"var ls = window.localStorage, items = {}; "
             "for (var i = 0, k; i < ls.length; ++i) "
@@ -3390,21 +3508,26 @@ class BaseCase(unittest.TestCase):
     # Application "Session Storage" controls
 
     def set_session_storage_item(self, key, value):
+        self.__check_scope()
         self.execute_script(
             "window.sessionStorage.setItem('{}', '{}');".format(key, value))
 
     def get_session_storage_item(self, key):
+        self.__check_scope()
         return self.execute_script(
             "return window.sessionStorage.getItem('{}');".format(key))
 
     def remove_session_storage_item(self, key):
+        self.__check_scope()
         self.execute_script(
             "window.sessionStorage.removeItem('{}');".format(key))
 
     def clear_session_storage(self):
+        self.__check_scope()
         self.execute_script("window.sessionStorage.clear();")
 
     def get_session_storage_keys(self):
+        self.__check_scope()
         return self.execute_script(
             "var ls = window.sessionStorage, keys = []; "
             "for (var i = 0; i < ls.length; ++i) "
@@ -3412,6 +3535,7 @@ class BaseCase(unittest.TestCase):
             "return keys;")
 
     def get_session_storage_items(self):
+        self.__check_scope()
         return self.execute_script(
             r"var ls = window.sessionStorage, items = {}; "
             "for (var i = 0, k; i < ls.length; ++i) "
@@ -3453,6 +3577,7 @@ class BaseCase(unittest.TestCase):
     def input(self, selector, text, by=By.CSS_SELECTOR,
               timeout=None, retry=False):
         """ Same as self.update_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3463,6 +3588,7 @@ class BaseCase(unittest.TestCase):
     def write(self, selector, text, by=By.CSS_SELECTOR,
               timeout=None, retry=False):
         """ Same as self.update_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3472,6 +3598,7 @@ class BaseCase(unittest.TestCase):
 
     def send_keys(self, selector, text, by=By.CSS_SELECTOR, timeout=None):
         """ Same as self.add_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3481,6 +3608,7 @@ class BaseCase(unittest.TestCase):
 
     def click_link(self, link_text, timeout=None):
         """ Same as self.click_link_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -3489,6 +3617,7 @@ class BaseCase(unittest.TestCase):
 
     def click_partial_link(self, partial_link_text, timeout=None):
         """ Same as self.click_partial_link_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -3498,6 +3627,7 @@ class BaseCase(unittest.TestCase):
     def wait_for_element_visible(self, selector, by=By.CSS_SELECTOR,
                                  timeout=None):
         """ Same as self.wait_for_element() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3513,6 +3643,7 @@ class BaseCase(unittest.TestCase):
             A hidden element still counts as appearing in the page HTML.
             If an element with "hidden" status is acceptable,
             use wait_for_element_not_visible() instead. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -3526,6 +3657,7 @@ class BaseCase(unittest.TestCase):
         """ Same as self.assert_element_absent()
             Will raise an exception if the element stays present.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -3555,21 +3687,27 @@ class BaseCase(unittest.TestCase):
     ############
 
     def add_css_link(self, css_link):
+        self.__check_scope()
         js_utils.add_css_link(self.driver, css_link)
 
     def add_js_link(self, js_link):
+        self.__check_scope()
         js_utils.add_js_link(self.driver, js_link)
 
     def add_css_style(self, css_style):
+        self.__check_scope()
         js_utils.add_css_style(self.driver, css_style)
 
     def add_js_code_from_link(self, js_link):
+        self.__check_scope()
         js_utils.add_js_code_from_link(self.driver, js_link)
 
     def add_js_code(self, js_code):
+        self.__check_scope()
         js_utils.add_js_code(self.driver, js_code)
 
     def add_meta_tag(self, http_equiv=None, content=None):
+        self.__check_scope()
         js_utils.add_meta_tag(
             self.driver, http_equiv=http_equiv, content=content)
 
@@ -4941,10 +5079,12 @@ class BaseCase(unittest.TestCase):
 
     def activate_jquery_confirm(self):
         """ See https://craftpip.github.io/jquery-confirm/ for usage. """
+        self.__check_scope()
         js_utils.activate_jquery_confirm(self.driver)
         self.wait_for_ready_state_complete()
 
     def activate_messenger(self):
+        self.__check_scope()
         js_utils.activate_messenger(self.driver)
         self.wait_for_ready_state_complete()
 
@@ -4955,6 +5095,7 @@ class BaseCase(unittest.TestCase):
             Locations: ["top_left", "top_center", "top_right",
                         "bottom_left", "bottom_center", "bottom_right"]
             max_messages is the limit of concurrent messages to display. """
+        self.__check_scope()
         if not theme:
             theme = "default"  # "flat"
         if not location:
@@ -4978,6 +5119,7 @@ class BaseCase(unittest.TestCase):
             You can also post messages by using =>
                 self.execute_script('Messenger().post("My Message")')
         """
+        self.__check_scope()
         if style not in ["info", "success", "error"]:
             style = "info"
         if not duration:
@@ -5001,6 +5143,7 @@ class BaseCase(unittest.TestCase):
                 selector: The selector of the Element to highlight.
                 by: The type of selector to search by. (Default: CSS Selector)
         """
+        self.__check_scope()
         self.__highlight_with_assert_success(message, selector, by=by)
 
     def post_success_message(self, message, duration=None, pause=True):
@@ -5010,6 +5153,7 @@ class BaseCase(unittest.TestCase):
                 duration: The time until the message vanishes. (Default: 2.55s)
                 pause: If True, the program waits until the message completes.
         """
+        self.__check_scope()
         if not duration:
             if not self.message_duration:
                 duration = settings.DEFAULT_MESSAGE_DURATION
@@ -5031,6 +5175,7 @@ class BaseCase(unittest.TestCase):
                 duration: The time until the message vanishes. (Default: 2.55s)
                 pause: If True, the program waits until the message completes.
         """
+        self.__check_scope()
         if not duration:
             if not self.message_duration:
                 duration = settings.DEFAULT_MESSAGE_DURATION
@@ -5051,6 +5196,7 @@ class BaseCase(unittest.TestCase):
         """ This method opens the start_page, creates a referral link there,
             and clicks on that link, which goes to the destination_page.
             (This generates real traffic for testing analytics software.) """
+        self.__check_scope()
         if not page_utils.is_valid_url(destination_page):
             raise Exception(
                 "Exception: destination_page {%s} is not a valid URL!"
@@ -5082,6 +5228,7 @@ class BaseCase(unittest.TestCase):
 
     def generate_traffic(self, start_page, destination_page, loops=1):
         """ Similar to generate_referral(), but can do multiple loops. """
+        self.__check_scope()
         for loop in range(loops):
             self.generate_referral(start_page, destination_page)
             time.sleep(0.05)
@@ -5092,6 +5239,7 @@ class BaseCase(unittest.TestCase):
             (When you want to create a referral to a website for traffic
             generation without increasing the bounce rate, you'll want to visit
             at least one additional page on that site with a button click.) """
+        self.__check_scope()
         if not type(pages) is tuple and not type(pages) is list:
             raise Exception(
                 "Exception: Expecting a list of website pages for chaining!")
@@ -5108,6 +5256,7 @@ class BaseCase(unittest.TestCase):
 
     def generate_traffic_chain(self, pages, loops=1):
         """ Similar to generate_referral_chain(), but for multiple loops. """
+        self.__check_scope()
         for loop in range(loops):
             self.generate_referral_chain(pages)
             time.sleep(0.05)
@@ -5118,6 +5267,7 @@ class BaseCase(unittest.TestCase):
                                  timeout=None):
         """ Waits for an element to appear in the HTML of a page.
             The element does not need be visible (it may be hidden). """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5129,6 +5279,7 @@ class BaseCase(unittest.TestCase):
     def wait_for_element(self, selector, by=By.CSS_SELECTOR, timeout=None):
         """ Waits for an element to appear in the HTML of a page.
             The element must be visible (it cannot be hidden). """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5140,6 +5291,7 @@ class BaseCase(unittest.TestCase):
     def get_element(self, selector, by=By.CSS_SELECTOR, timeout=None):
         """ Same as wait_for_element_present() - returns the element.
             The element does not need be visible (it may be hidden). """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5153,6 +5305,7 @@ class BaseCase(unittest.TestCase):
             Waits for an element to appear in the HTML of a page.
             The element does not need be visible (it may be hidden).
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5162,6 +5315,7 @@ class BaseCase(unittest.TestCase):
 
     def find_element(self, selector, by=By.CSS_SELECTOR, timeout=None):
         """ Same as wait_for_element_visible() - returns the element """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5172,6 +5326,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_element_visible(), but returns nothing.
             As above, will raise an exception if nothing can be found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5192,6 +5347,7 @@ class BaseCase(unittest.TestCase):
                                timeout=None):
         """ Same as self.assert_element()
             As above, will raise an exception if nothing can be found. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5203,6 +5359,7 @@ class BaseCase(unittest.TestCase):
 
     def wait_for_text_visible(self, text, selector="html", by=By.CSS_SELECTOR,
                               timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5214,6 +5371,7 @@ class BaseCase(unittest.TestCase):
     def wait_for_exact_text_visible(self, text, selector="html",
                                     by=By.CSS_SELECTOR,
                                     timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5225,6 +5383,7 @@ class BaseCase(unittest.TestCase):
     def wait_for_text(self, text, selector="html", by=By.CSS_SELECTOR,
                       timeout=None):
         """ The shorter version of wait_for_text_visible() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5235,6 +5394,7 @@ class BaseCase(unittest.TestCase):
     def find_text(self, text, selector="html", by=By.CSS_SELECTOR,
                   timeout=None):
         """ Same as wait_for_text_visible() - returns the element """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5245,6 +5405,7 @@ class BaseCase(unittest.TestCase):
     def assert_text_visible(self, text, selector="html", by=By.CSS_SELECTOR,
                             timeout=None):
         """ Same as assert_text() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5256,6 +5417,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_text_visible()
             Raises an exception if the element or the text is not found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5282,6 +5444,7 @@ class BaseCase(unittest.TestCase):
             (Extra whitespace at the beginning or the end doesn't count.)
             Raises an exception if the element or the text is not found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5305,6 +5468,7 @@ class BaseCase(unittest.TestCase):
     ############
 
     def wait_for_link_text_present(self, link_text, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         start_ms = time.time() * 1000.0
@@ -5327,6 +5491,7 @@ class BaseCase(unittest.TestCase):
         page_actions.timeout_exception("NoSuchElementException", message)
 
     def wait_for_partial_link_text_present(self, link_text, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         start_ms = time.time() * 1000.0
@@ -5349,6 +5514,7 @@ class BaseCase(unittest.TestCase):
         page_actions.timeout_exception("NoSuchElementException", message)
 
     def wait_for_link_text_visible(self, link_text, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5358,6 +5524,7 @@ class BaseCase(unittest.TestCase):
 
     def wait_for_link_text(self, link_text, timeout=None):
         """ The shorter version of wait_for_link_text_visible() """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5366,6 +5533,7 @@ class BaseCase(unittest.TestCase):
 
     def find_link_text(self, link_text, timeout=None):
         """ Same as wait_for_link_text_visible() - returns the element """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5376,6 +5544,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_link_text_visible(), but returns nothing.
             As above, will raise an exception if nothing can be found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5392,6 +5561,7 @@ class BaseCase(unittest.TestCase):
         return True
 
     def wait_for_partial_link_text(self, partial_link_text, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5401,6 +5571,7 @@ class BaseCase(unittest.TestCase):
 
     def find_partial_link_text(self, partial_link_text, timeout=None):
         """ Same as wait_for_partial_link_text() - returns the element """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5412,6 +5583,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_partial_link_text(), but returns nothing.
             As above, will raise an exception if nothing can be found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5435,6 +5607,7 @@ class BaseCase(unittest.TestCase):
             A hidden element still counts as appearing in the page HTML.
             If an element with "hidden" status is acceptable,
             use wait_for_element_not_visible() instead. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5448,6 +5621,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_element_absent() - returns nothing.
             As above, will raise an exception if the element stays present.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5462,6 +5636,7 @@ class BaseCase(unittest.TestCase):
         """ Waits for an element to no longer be visible on a page.
             The element can be non-existent in the HTML or hidden on the page
             to qualify as not visible. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5475,6 +5650,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_element_not_visible() - returns nothing.
             As above, will raise an exception if the element stays visible.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5487,6 +5663,7 @@ class BaseCase(unittest.TestCase):
     def wait_for_text_not_visible(self, text, selector="html",
                                   by=By.CSS_SELECTOR,
                                   timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5501,6 +5678,7 @@ class BaseCase(unittest.TestCase):
         """ Similar to wait_for_text_not_visible()
             Raises an exception if the element or the text is not found.
             Returns True if successful. Default timeout = SMALL_TIMEOUT. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5510,6 +5688,7 @@ class BaseCase(unittest.TestCase):
     ############
 
     def wait_for_and_accept_alert(self, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5517,6 +5696,7 @@ class BaseCase(unittest.TestCase):
         return page_actions.wait_for_and_accept_alert(self.driver, timeout)
 
     def wait_for_and_dismiss_alert(self, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5524,6 +5704,7 @@ class BaseCase(unittest.TestCase):
         return page_actions.wait_for_and_dismiss_alert(self.driver, timeout)
 
     def wait_for_and_switch_to_alert(self, timeout=None):
+        self.__check_scope()
         if not timeout:
             timeout = settings.LARGE_TIMEOUT
         if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
@@ -5534,6 +5715,7 @@ class BaseCase(unittest.TestCase):
 
     def accept_alert(self, timeout=None):
         """ Same as wait_for_and_accept_alert(), but smaller default T_O """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5542,6 +5724,7 @@ class BaseCase(unittest.TestCase):
 
     def dismiss_alert(self, timeout=None):
         """ Same as wait_for_and_dismiss_alert(), but smaller default T_O """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5550,6 +5733,7 @@ class BaseCase(unittest.TestCase):
 
     def switch_to_alert(self, timeout=None):
         """ Same as wait_for_and_switch_to_alert(), but smaller default T_O """
+        self.__check_scope()
         if not timeout:
             timeout = settings.SMALL_TIMEOUT
         if self.timeout_multiplier and timeout == settings.SMALL_TIMEOUT:
@@ -5656,6 +5840,7 @@ class BaseCase(unittest.TestCase):
                 self.check_window(name="github_page", level=2)
                 self.check_window(name="wikipedia_page", level=3)
         """
+        self.__check_scope()
         if level == "0":
             level = 0
         if level == "1":
@@ -5793,6 +5978,7 @@ class BaseCase(unittest.TestCase):
 
     def __get_new_timeout(self, timeout):
         """ When using --timeout_multiplier=#.# """
+        self.__check_scope()
         try:
             timeout_multiplier = float(self.timeout_multiplier)
             if timeout_multiplier <= 0.5:
@@ -5805,6 +5991,25 @@ class BaseCase(unittest.TestCase):
 
     ############
 
+    def __check_scope(self):
+        if hasattr(self, 'browser'):  # self.browser stores the type of browser
+            return  # All good: setUp() already initialized variables in "self"
+        else:
+            from seleniumbase.common.exceptions import OutOfScopeException
+            message = (
+                "\n It looks like you are trying to call a SeleniumBase method"
+                "\n from outside the scope of your test class's `self` object."
+                "\n When using page objects, be sure to pass the `self` object"
+                "\n from your test class into your page object methods so that"
+                "\n they can call BaseCase class methods with all the required"
+                "\n variables, which are initialized during the setUp() method"
+                "\n that runs automatically before all tests called by pytest."
+                "\n The `self` object is where all test variables are defined."
+                )
+            raise OutOfScopeException(message)
+
+    ############
+
     def __get_exception_message(self):
         """ This method extracts the message from an exception if there
             was an exception that occurred during the test, assuming
@@ -5843,6 +6048,7 @@ class BaseCase(unittest.TestCase):
 
     def __add_deferred_assert_failure(self):
         """ Add a deferred_assert failure to a list for future processing. """
+        self.__check_scope()
         current_url = self.driver.current_url
         message = self.__get_exception_message()
         self.__deferred_assert_failures.append(
@@ -5856,6 +6062,7 @@ class BaseCase(unittest.TestCase):
         """ A non-terminating assertion for an element on a page.
             Failures will be saved until the process_deferred_asserts()
             method is called from inside a test, likely at the end of it. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.MINI_TIMEOUT
         if self.timeout_multiplier and timeout == settings.MINI_TIMEOUT:
@@ -5881,6 +6088,7 @@ class BaseCase(unittest.TestCase):
         """ A non-terminating assertion for text from an element on a page.
             Failures will be saved until the process_deferred_asserts()
             method is called from inside a test, likely at the end of it. """
+        self.__check_scope()
         if not timeout:
             timeout = settings.MINI_TIMEOUT
         if self.timeout_multiplier and timeout == settings.MINI_TIMEOUT: