Add methods: get_property() and get_text_content()

Author: mdmintz

help_docs/method_summary.md

@@ -110,6 +110,10 @@ self.remove_attribute(selector, attribute, by=By.CSS_SELECTOR, timeout=None)
 
 self.remove_attributes(selector, attribute, by=By.CSS_SELECTOR)
 
+self.get_property(selector, property, by=By.CSS_SELECTOR, timeout=None)
+
+self.get_text_content(selector, by=By.CSS_SELECTOR, timeout=None)
+
 self.get_property_value(selector, property, by=By.CSS_SELECTOR, timeout=None)
 
 self.get_image_url(selector, by=By.CSS_SELECTOR, timeout=None)

seleniumbase/fixtures/base_case.py

@@ -1403,6 +1403,50 @@ def remove_attributes(self, selector, attribute, by=By.CSS_SELECTOR):
         except Exception:
             pass
 
+    def get_property(
+        self, selector, property, by=By.CSS_SELECTOR, timeout=None
+    ):
+        """Returns the property value of an element.
+        This is not the same as self.get_property_value(), which returns
+        the value of an element's computed style using a different algorithm.
+        If no result is found, an empty string (instead of None) is returned.
+        Example:
+            html_text = self.get_property(SELECTOR, "textContent")
+        """
+        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)
+        selector, by = self.__recalculate_selector(selector, by)
+        self.wait_for_ready_state_complete()
+        time.sleep(0.01)
+        element = page_actions.wait_for_element_present(
+            self.driver, selector, by, timeout
+        )
+        try:
+            property_value = element.get_property(property)
+        except (StaleElementReferenceException, ENI_Exception):
+            self.wait_for_ready_state_complete()
+            time.sleep(0.14)
+            element = page_actions.wait_for_element_present(
+                self.driver, selector, by, timeout
+            )
+            property_value = element.get_property(property)
+        if not property_value:
+            return ""
+        return property_value
+
+    def get_text_content(self, selector, by=By.CSS_SELECTOR, timeout=None):
+        """Returns the text that appears in the HTML for an element.
+        This is different from "self.get_text(selector, by=By.CSS_SELECTOR)"
+        because that only returns the visible text on a page for an element,
+        rather than the HTML text that's being returned from this method."""
+        self.__check_scope()
+        return self.get_property(
+            selector, property="textContent", by=by, timeout=timeout
+        )
+
     def get_property_value(
         self, selector, property, by=By.CSS_SELECTOR, timeout=None
     ):