| 30 | |
| 31 | |
| 32 | class SwitchTo: |
| 33 | def __init__(self, driver) -> None: |
| 34 | import weakref |
| 35 | |
| 36 | self._driver = weakref.proxy(driver) |
| 37 | |
| 38 | @property |
| 39 | def active_element(self) -> WebElement: |
| 40 | """Returns the element with focus, or BODY if nothing has focus. |
| 41 | |
| 42 | Example: |
| 43 | element = driver.switch_to.active_element |
| 44 | """ |
| 45 | return self._driver.execute(Command.W3C_GET_ACTIVE_ELEMENT)["value"] |
| 46 | |
| 47 | @property |
| 48 | def alert(self) -> Alert: |
| 49 | """Switches focus to an alert on the page. |
| 50 | |
| 51 | Example: |
| 52 | alert = driver.switch_to.alert |
| 53 | """ |
| 54 | from selenium.webdriver.common.alert import Alert |
| 55 | |
| 56 | alert = Alert(self._driver) |
| 57 | _ = alert.text |
| 58 | return alert |
| 59 | |
| 60 | def default_content(self) -> None: |
| 61 | """Switch focus to the default frame. |
| 62 | |
| 63 | Example: |
| 64 | driver.switch_to.default_content() |
| 65 | """ |
| 66 | self._driver.execute(Command.SWITCH_TO_FRAME, {"id": None}) |
| 67 | |
| 68 | def frame(self, frame_reference: str | int | WebElement) -> None: |
| 69 | """Switch focus to the specified frame by index, name, or element. |
| 70 | |
| 71 | Args: |
| 72 | frame_reference: The name of the frame to switch to, an integer representing the index, |
| 73 | or a WebElement that is an (i)frame to switch to. |
| 74 | |
| 75 | Example: |
| 76 | driver.switch_to.frame("frame_name") |
| 77 | driver.switch_to.frame(1) |
| 78 | driver.switch_to.frame(driver.find_elements(By.TAG_NAME, "iframe")[0]) |
| 79 | """ |
| 80 | if isinstance(frame_reference, str): |
| 81 | try: |
| 82 | frame_reference = self._driver.find_element(By.ID, frame_reference) |
| 83 | except NoSuchElementException: |
| 84 | try: |
| 85 | frame_reference = self._driver.find_element(By.NAME, frame_reference) |
| 86 | except NoSuchElementException as exc: |
| 87 | raise NoSuchFrameException(frame_reference) from exc |
| 88 | |
| 89 | self._driver.execute(Command.SWITCH_TO_FRAME, {"id": frame_reference}) |