Switch focus to the specified frame by index, name, or element. Args: frame_reference: The name of the frame to switch to, an integer representing the index, or a WebElement that is an (i)frame to switch to. Example: driver.switch_to.fram
(self, frame_reference: str | int | WebElement)
| 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}) |
| 90 | |
| 91 | def new_window(self, type_hint: str | None = None) -> None: |
| 92 | """Switches to a new top-level browsing context. |
nothing calls this directly
no test coverage detected