frame

The command to switch the driver's context to the frame given its name or id.

Syntax

py.switch_to.frame(name_or_id: str, timeout: int = 0) -> Pylenium

Usage

correct usage

# switch to an iframe with name of 'main-content'
py.switch_to.frame("main-content")

---or--- # chain a Pylenium command

py.switch_to.frame("main-content").contains("Add New").click()

Arguments

• name_or_id (str) - The name or id attribute value of the <frame> element

• timeout=0 (int) - The number of seconds to wait for the frame to be switched to

Yields

• Pylenium - The current instance of Pylenium so you can chain commands

Examples

<div>
    <frame id='foo'>
        <a href='/different-page' id='bar'>Link in iframe</a>
    </frame>
</div>

If we wanted to click the link above, we would need to:

1. Switch the driver's context to the iframe

2. Then perform the click

This is a piece of cake with Pylenium:

py.switch_to.frame("foo").get("#bar").click()