Add a new method: "self.is_element_enabled(selector)"

Author: mdmintz

help_docs/method_summary.md

@@ -60,6 +60,8 @@ self.is_element_present(selector, by=By.CSS_SELECTOR)
 
 self.is_element_visible(selector, by=By.CSS_SELECTOR)
 
+self.is_element_enabled(selector, by=By.CSS_SELECTOR)
+
 self.is_text_visible(text, selector="html", by=By.CSS_SELECTOR)
 
 self.is_link_text_visible(link_text)

seleniumbase/fixtures/base_case.py

@@ -578,6 +578,11 @@ def is_element_visible(self, selector, by=By.CSS_SELECTOR):
         selector, by = self.__recalculate_selector(selector, by)
         return page_actions.is_element_visible(self.driver, selector, by)
 
+    def is_element_enabled(self, selector, by=By.CSS_SELECTOR):
+        self.wait_for_ready_state_complete()
+        selector, by = self.__recalculate_selector(selector, by)
+        return page_actions.is_element_enabled(self.driver, selector, by)
+
     def is_text_visible(self, text, selector="html", by=By.CSS_SELECTOR):
         self.wait_for_ready_state_complete()
         time.sleep(0.01)

seleniumbase/fixtures/page_actions.py

@@ -73,6 +73,23 @@ def is_element_visible(driver, selector, by=By.CSS_SELECTOR):
         return False
 
 
+def is_element_enabled(driver, selector, by=By.CSS_SELECTOR):
+    """
+    Returns whether the specified element selector is enabled on the page.
+    @Params
+    driver - the webdriver object (required)
+    selector - the locator for identifying the page element (required)
+    by - the type of selector being used (Default: By.CSS_SELECTOR)
+    @Returns
+    Boolean (is element enabled)
+    """
+    try:
+        element = driver.find_element(by=by, value=selector)
+        return element.is_enabled()
+    except Exception:
+        return False
+
+
 def is_text_visible(driver, text, selector, by=By.CSS_SELECTOR):
     """
     Returns whether the specified text is visible in the specified selector.