Update method names to be more clear

Author: mdmintz

help_docs/method_summary.md

@@ -73,9 +73,9 @@ self.is_text_visible(text, selector, by=By.CSS_SELECTOR)
 
 self.find_visible_elements(selector, by=By.CSS_SELECTOR)
 
-self.is_element_in_frame(selector, by=By.CSS_SELECTOR)
+self.is_element_in_an_iframe(selector, by=By.CSS_SELECTOR)
 
-self.enter_frame_of_element(selector, by=By.CSS_SELECTOR)
+self.switch_to_frame_of_element(selector, by=By.CSS_SELECTOR)
 
 self.execute_script(script)
 

seleniumbase/fixtures/base_case.py

@@ -615,8 +615,8 @@ 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 is_element_in_frame(self, selector, by=By.CSS_SELECTOR):
-        """ Returns True if the selector's element is located in an iFrame.
+    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. """
         selector, by = self._recalculate_selector(selector, by)
         if self.is_element_present(selector, by=by):
@@ -639,10 +639,11 @@ def is_element_in_frame(self, selector, by=By.CSS_SELECTOR):
             self.switch_to_default_content()
         return False
 
-    def enter_frame_of_element(self, selector, by=By.CSS_SELECTOR):
-        """ Returns the frame name of the selector's element if in an iFrame.
-            Also enters the iFrame if the element was inside an iFrame.
-            If the element is not in an iFrame, returns None. """
+    def switch_to_frame_of_element(self, selector, by=By.CSS_SELECTOR):
+        """ Set driver control to the iframe of the element (assuming the
+            element is in a single-nested iframe) and returns the iframe name.
+            If element is not in an iframe, returns None, and nothing happens.
+            May not work if multiple iframes are nested within each other. """
         selector, by = self._recalculate_selector(selector, by)
         if self.is_element_present(selector, by=by):
             return None