Add method: "is_exact_text_visible(text, selector)"

Author: mdmintz

help_docs/method_summary.md

@@ -78,6 +78,8 @@ self.is_element_enabled(selector, by="css selector")
 
 self.is_text_visible(text, selector="html", by="css selector")
 
+self.is_exact_text_visible(text, selector="html", by="css selector")
+
 self.is_attribute_present(selector, attribute, value=None, by="css selector")
 
 self.is_link_text_visible(link_text)

seleniumbase/fixtures/base_case.py

@@ -1232,6 +1232,16 @@ def is_text_visible(self, text, selector="html", by="css selector"):
             self.driver, text, selector, by, self.browser
         )
 
+    def is_exact_text_visible(self, text, selector="html", by="css selector"):
+        self.wait_for_ready_state_complete()
+        time.sleep(0.01)
+        selector, by = self.__recalculate_selector(selector, by)
+        if self.__is_shadow_selector(selector):
+            return self.__is_shadow_exact_text_visible(text, selector)
+        return page_actions.is_exact_text_visible(
+            self.driver, text, selector, by, self.browser
+        )
+
     def is_attribute_present(
         self, selector, attribute, value=None, by="css selector"
     ):
@@ -13073,6 +13083,22 @@ def __is_shadow_text_visible(self, text, selector):
         except Exception:
             return False
 
+    def __is_shadow_exact_text_visible(self, text, selector):
+        text = str(text)
+        try:
+            element = self.__get_shadow_element(selector, timeout=0.1)
+            if self.browser == "safari":
+                return (
+                    element.is_displayed()
+                    and text in element.get_attribute("innerText")
+                )
+            return (
+                element.is_displayed()
+                and text.strip() == element.text.strip()
+            )
+        except Exception:
+            return False
+
     def __is_shadow_attribute_present(self, selector, attribute, value=None):
         try:
             element = self.__get_shadow_element(selector, timeout=0.1)

seleniumbase/fixtures/page_actions.py

@@ -133,6 +133,43 @@ def is_text_visible(driver, text, selector, by="css selector", browser=None):
         return False
 
 
+def is_exact_text_visible(
+    driver,
+    text,
+    selector,
+    by="css selector",
+    browser=None
+):
+    """
+    Returns whether the exact text is visible in the given selector.
+    (Ignores leading and trailing whitespace)
+    @Params
+    driver - the webdriver object (required)
+    text - the text string to search for (required)
+    selector - the locator for identifying the page element (required)
+    by - the type of selector being used (Default: "css selector")
+    @Returns
+    Boolean (is text visible)
+    """
+    text = str(text)
+    try:
+        element = driver.find_element(by=by, value=selector)
+        element_text = element.text
+        if browser == "safari":
+            if element.tag_name.lower() in ["input", "textarea"]:
+                element_text = element.get_attribute("value")
+            else:
+                element_text = element.get_attribute("innerText")
+        elif element.tag_name.lower() in ["input", "textarea"]:
+            element_text = element.get_property("value")
+        return (
+            element.is_displayed()
+            and text.strip() == element_text.strip()
+        )
+    except Exception:
+        return False
+
+
 def is_attribute_present(
     driver, selector, attribute, value=None, by="css selector"
 ):