Merge pull request #252 from seleniumbase/add-click-visible-elements

Add click_visible_elements(selector) method

Author: mdmintz

help_docs/method_summary.md

@@ -75,6 +75,8 @@ self.find_elements(selector, by=By.CSS_SELECTOR)
 
 self.find_visible_elements(selector, by=By.CSS_SELECTOR)
 
+self.click_visible_elements(selector, by=By.CSS_SELECTOR)
+
 self.is_element_in_an_iframe(selector, by=By.CSS_SELECTOR)
 
 self.switch_to_frame_of_element(selector, by=By.CSS_SELECTOR)

seleniumbase/config/proxy_list.py

@@ -15,14 +15,14 @@
 Example proxies in PROXY_LIST below are not guaranteed to be active or secure.
 If you don't already have a proxy server to connect to,
 you can try finding one from one of following sites:
-* https://www.proxynova.com/proxy-server-list/port-8080/
+* https://www.proxynova.com/proxy-server-list/country-us/
 * https://www.us-proxy.org/
 * https://hidemy.name/en/proxy-list/?country=US&type=h#list
 * http://proxyservers.pro/proxy/list/protocol/http/country/US/
 """
 
 PROXY_LIST = {
-    "example1": "104.248.122.30:8080",  # (Example) - set your own proxy here
+    "example1": "192.241.132.219:80",  # (Example) - set your own proxy here
     "proxy1": None,
     "proxy2": None,
     "proxy3": None,

seleniumbase/fixtures/base_case.py

@@ -663,6 +663,36 @@ def find_visible_elements(self, selector, by=By.CSS_SELECTOR):
             by = By.LINK_TEXT
         return page_actions.find_visible_elements(self.driver, selector, by)
 
+    def click_visible_elements(self, selector, by=By.CSS_SELECTOR):
+        """ Finds all matching page elements and clicks visible ones in order.
+            If a click reloads or opens a new page, the clicking will stop.
+            Works best for actions such as clicking all checkboxes on a page.
+            Example:  self.click_visible_elements('input[type="checkbox"]')
+        """
+        elements = self.find_elements(selector, by=by)
+        count = 0
+        for element in elements:
+            count += 1
+            if count == 1:
+                self.wait_for_ready_state_complete()
+                if self.is_element_visible(selector, by=by):
+                    self.click(selector, by=by)
+            else:
+                self.wait_for_ready_state_complete()
+                try:
+                    if element.is_displayed():
+                        self.__scroll_to_element(element)
+                        element.click()
+                except (StaleElementReferenceException, ENI_Exception):
+                    self.wait_for_ready_state_complete()
+                    time.sleep(0.05)
+                    try:
+                        if element.is_displayed():
+                            self.__scroll_to_element(element)
+                            element.click()
+                    except (StaleElementReferenceException, ENI_Exception):
+                        return  # Probably on new page / Elements are all stale
+
     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. """

setup.py

@@ -17,7 +17,7 @@
 
 setup(
     name='seleniumbase',
-    version='1.17.8',
+    version='1.17.9',
     description='All-in-One Test Automation Framework',
     long_description=long_description,
     long_description_content_type='text/markdown',