Using selenium element object

---

title: Using a selenium element object

If you want to use a selenium object directly (e.g. to implement functionality which seleniumdirector doesn't have), you can use .element.

It's generally a good idea to use the element's iframe context manager. If your element isn't in an iframe it does nothing. If there is an iframe it switches to it.

HTML:

iframe.html:

<p id="id_dashboard_message">hello!</a>

index.html:

<div id="id_login_page" class="form-login">
<input type="text" id="id_username" class="form-control input-sm chat-input" placeholder="username" /></br>
<input type="text" id="id_password" class="form-control input-sm chat-input" placeholder="password" /></br>
<div class="wrapper">
<span class="group-btn">
<a id="id_ok_button" href="/dashboard.html" class="btn btn-primary btn-md">login <i class="fa fa-sign-in"></i></a>
</span>
</div>
</div>

dashboard.html:

<div class="form-login">
  <h4 id="id_this_is_a_dashboard_element">Dashboard</h4>
  <iframe id="message_iframe" src="iframe.html" />
</div>

selectors.yml:

login:
  appears when: login page
  elements:
    login page: id=id_login_page
    username:
      id: id_username
    password:
      id: id_password
    ok:
      id: id_ok_button
dashboard:
  appears when: dashboard identifier
  elements:
    dashboard identifier: id=id_this_is_a_dashboard_element
    message iframe: id=message_iframe
    message:
      in iframe: message iframe
      id: id_dashboard_message

set up:

from seleniumdirector import WebDirector
from selenium import webdriver

driver = webdriver.Chrome()
selector = WebDirector(driver, "../selectors.yml", default_timeout=5)

Successful:

selector.visit("http://localhost:8000")
selector.wait_for_page("login")

# Not strictly necessary
with selector.the("username").iframe:
    selector.the("username").element.send_keys("login")

# Not strictly necessary
with selector.the("password").iframe:
    selector.the("password").send_keys("password")

selector.the("ok").click()
selector.wait_for_page("dashboard")

# Necessary
with selector.the("message").iframe:
    selector.the("message").element.click()

selector.the("message").should_contain("hello!")

driver.quit()

Executable specification

Documentation automatically generated from using-selenium-element-object.story..