Add more methods for text-based assertions

Author: mdmintz

Diff for: help_docs/method_summary.md

@@ -713,8 +713,9 @@ self.find_text(text, selector="html", by="css selector", timeout=None)
 # Duplicates: self.wait_for_text(text, selector="html", by="css selector", timeout=None)
 #             self.wait_for_text_visible(text, selector="html", by="css selector", timeout=None)
 
-self.wait_for_exact_text_visible(
-    text, selector="html", by="css selector", timeout=None)
+self.find_exact_text(text, selector="html", by="css selector", timeout=None)
+# Duplicates: self.wait_for_exact_text(text, selector="html", by="css selector", timeout=None)
+#             self.wait_for_exact_text_visible(text, selector="html", by="css selector", timeout=None)
 
 self.assert_text(text, selector="html", by="css selector", timeout=None)
 # Duplicates: self.assert_text_visible(text, selector="html", by="css selector", timeout=None)
@@ -762,8 +763,12 @@ self.assert_element_not_visible(selector, by="css selector", timeout=None)
 
 self.wait_for_text_not_visible(text, selector="html", by="css selector", timeout=None)
 
+self.wait_for_exact_text_not_visible(text, selector="html", by="css selector", timeout=None)
+
 self.assert_text_not_visible(text, selector="html", by="css selector", timeout=None)
 
+self.assert_exact_text_not_visible(text, selector="html", by="css selector", timeout=None)
+
 ############
 
 self.wait_for_attribute_not_present(

Diff for: seleniumbase/fixtures/base_case.py

@@ -4337,6 +4337,7 @@ def __process_recorded_actions(self):
         ext_actions.append("as_at")
         ext_actions.append("as_te")
         ext_actions.append("astnv")
+        ext_actions.append("aetnv")
         ext_actions.append("as_et")
         ext_actions.append("wf_el")
         ext_actions.append("sw_fr")
@@ -4740,6 +4741,7 @@ def __process_recorded_actions(self):
                 action[0] == "as_te"
                 or action[0] == "as_et"
                 or action[0] == "astnv"
+                or action[0] == "aetnv"
                 or action[0] == "da_te"
                 or action[0] == "da_et"
             ):
@@ -4752,6 +4754,8 @@ def __process_recorded_actions(self):
                     method = "assert_exact_text"
                 elif action[0] == "astnv":
                     method = "assert_text_not_visible"
+                elif action[0] == "aetnv":
+                    method = "assert_exact_text_not_visible"
                 elif action[0] == "da_te":
                     method = "deferred_assert_text"
                 elif action[0] == "da_et":
@@ -8541,6 +8545,19 @@ def wait_for_text(
             text, selector, by=by, timeout=timeout
         )
 
+    def wait_for_exact_text(
+        self, text, selector="html", by="css selector", timeout=None
+    ):
+        """The shorter version of wait_for_exact_text_visible()"""
+        self.__check_scope()
+        if not timeout:
+            timeout = settings.LARGE_TIMEOUT
+        if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
+            timeout = self.__get_new_timeout(timeout)
+        return self.wait_for_exact_text_visible(
+            text, selector, by=by, timeout=timeout
+        )
+
     def find_text(
         self, text, selector="html", by="css selector", timeout=None
     ):
@@ -8554,6 +8571,19 @@ def find_text(
             text, selector, by=by, timeout=timeout
         )
 
+    def find_exact_text(
+        self, text, selector="html", by="css selector", timeout=None
+    ):
+        """Same as wait_for_exact_text_visible() - returns the element"""
+        self.__check_scope()
+        if not timeout:
+            timeout = settings.LARGE_TIMEOUT
+        if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
+            timeout = self.__get_new_timeout(timeout)
+        return self.wait_for_exact_text_visible(
+            text, selector, by=by, timeout=timeout
+        )
+
     def assert_text_visible(
         self, text, selector="html", by="css selector", timeout=None
     ):
@@ -8920,6 +8950,19 @@ def wait_for_text_not_visible(
             self.driver, text, selector, by, timeout, self.browser
         )
 
+    def wait_for_exact_text_not_visible(
+        self, text, selector="html", by="css selector", timeout=None
+    ):
+        self.__check_scope()
+        if not timeout:
+            timeout = settings.LARGE_TIMEOUT
+        if self.timeout_multiplier and timeout == settings.LARGE_TIMEOUT:
+            timeout = self.__get_new_timeout(timeout)
+        selector, by = self.__recalculate_selector(selector, by)
+        return page_actions.wait_for_exact_text_not_visible(
+            self.driver, text, selector, by, timeout, self.browser
+        )
+
     def assert_text_not_visible(
         self, text, selector="html", by="css selector", timeout=None
     ):
@@ -8944,6 +8987,32 @@ def assert_text_not_visible(
                         self.__extra_actions.append(action)
         return True
 
+    def assert_exact_text_not_visible(
+        self, text, selector="html", by="css selector", timeout=None
+    ):
+        """Similar to wait_for_exact_text_not_visible()
+        Raises an exception if the exact text is still visible after timeout.
+        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:
+            timeout = self.__get_new_timeout(timeout)
+        self.wait_for_exact_text_not_visible(
+            text, selector, by=by, timeout=timeout
+        )
+        if self.recorder_mode:
+            url = self.get_current_url()
+            if url and len(url) > 0:
+                if ("http:") in url or ("https:") in url or ("file:") in url:
+                    if self.get_session_storage_item("pause_recorder") == "no":
+                        time_stamp = self.execute_script("return Date.now();")
+                        origin = self.get_origin()
+                        text_selector = [text, selector]
+                        action = ["aetnv", text_selector, origin, time_stamp]
+                        self.__extra_actions.append(action)
+        return True
+
     ############
 
     def wait_for_attribute_not_present(

Diff for: seleniumbase/fixtures/page_actions.py

@@ -1031,6 +1031,54 @@ def wait_for_text_not_visible(
     timeout_exception(Exception, message)
 
 
+def wait_for_exact_text_not_visible(
+    driver,
+    text,
+    selector,
+    by="css selector",
+    timeout=settings.LARGE_TIMEOUT,
+    browser=None,
+):
+    """
+    Searches for the text in the element of the given selector on the page.
+    Returns True if the element is missing the exact text within the timeout.
+    Raises an exception if the exact text is still present after the timeout.
+    @Params
+    driver - the webdriver object (required)
+    text - the text that is being searched for in the element (required)
+    selector - the locator for identifying the page element (required)
+    by - the type of selector being used (Default: "css selector")
+    timeout - the time to wait for elements in seconds
+    @Returns
+    A web element object that contains the text searched for
+    """
+    text = str(text)
+    start_ms = time.time() * 1000.0
+    stop_ms = start_ms + (timeout * 1000.0)
+    for x in range(int(timeout * 10)):
+        shared_utils.check_if_time_limit_exceeded()
+        if not is_exact_text_visible(
+            driver, text, selector, by=by, browser=browser
+        ):
+            return True
+        now_ms = time.time() * 1000.0
+        if now_ms >= stop_ms:
+            break
+        time.sleep(0.1)
+    plural = "s"
+    if timeout == 1:
+        plural = ""
+    message = (
+        "Exact text {%s} for {%s} was still visible after %s second%s!" % (
+            text,
+            selector,
+            timeout,
+            plural,
+        )
+    )
+    timeout_exception(Exception, message)
+
+
 def wait_for_attribute_not_present(
     driver,
     selector,