MCPcopy Create free account
hub / github.com/SeleniumHQ/selenium / SwitchTo

Class SwitchTo

py/selenium/webdriver/remote/switch_to.py:32–141  ·  view source on GitHub ↗

Source from the content-addressed store, hash-verified

30
31
32class 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})

Callers 1

__init__Method · 0.90

Calls

no outgoing calls

Tested by

no test coverage detected