3 跳转
使用Webdriver要做的第一件事情是跳转到一个页面。一般的方式是通过调用get方法。
driver.get("http://www.python.org")
WebDriver在返回对测试或脚本的控制之前一直等到页面完全载入为止。但是如果页面使用了很多AJAX,WebDriver也许不知道什么时候页面会完全载入,就不值得这么做了。如果你需要确保这样的页面完全载入,可以使用waits方法。
3.1 与页面交互
只是能到达页面并不是十分有用,我们很想做的是与页面交互。或者,更精确地。与页面里的HTML元素。首先,我们需要找到一个元素。WebDriver提供了很多方法来需找元素。假设一个元素定义为:
<input type="text" name="passwd" id="passwd-id" />
你可以使用以下方法去找到这个元素:
Element = driver.find_element_by_id(“passwd_id”)
Element = driver.find_element_by_name(“passwd”)
Element = driver.find_element_by_xpath(“/input[@id=’passwd-id’]”)
还可以通过文字找到一个链接,但是要小心!这个文字必须是完全匹配!在WebDriver里使用XPATH也要小心。 如果有多个元素满足查询,将只有第一个满足条件的被返回。如果没有发现任何元素,将会报NoSuchElementException。
WebDriver 有一个基于对象的API。我们使用相同的接口来代表各种元素。这意味着在使用IDE的自动完成功能的时候,你或许看到很多可以调用的方法。但是不是所有的都行得通或者可行。但是无需担心!WebDriver将试图去做正确的事情,而且如果你调用了一个行不通的方法,会抛出一个异常。
你得到了一个元素,你能做什么呢?首先,你也许想在输入框中输入一段文字。
Element.send_keys(“some text”)
你可以通过Keys类模仿按箭头键
Element.send_keys(“and some”, Keys.ARROW_DOWN)
在任意元素上都是可以调用send_keys的,这使得测试键盘快捷键比如用在Gmail上的,成为可能。一个副作用是在输入框中输入字符将不会自动清空。反而,你输入的将会被添加在已有文本之后。你可以很容易使用clear方法清空输入框或输入区域的内容。
Element.clear()
3.2 填充表单
我们已经看到如何在输入框里输入字符,但是,其他元素呢?你可以选择选择框的状态,你可以使用setSelected来设置比如选项标签为选中状态。处理SELECT选项并不是太坏。
Select = driver.find_element_by_xpath(“//select”)
All_options = select.find_element_by_tag_name(“option”)
For option in all_options:
Print “value is: %s” %option.get_attribute(“value”)
Option.click()
这将会发现页面上第一个SELECT元素,然后循环通过每一根的OPTION,打印出他们的值,然后依次选中每个。
当你完成填充表单之后,你也许想提交它。一个办法是找到submit按钮并点击它。
# Assume the button has the ID “submit”
Driver.find_element_by_id(‘submit’).click()
或者,WebDriver在每个元素上都有很方便的submit方法。如果你在一个form的元素上调用这个方法,WebDriver将会查询DOM树,直至发现包含它的form然后调用submit。如果元素没有在form里面,将会抛出NoSuchElementExcellent
Element.submit()
3.3 托和拽
Element = driver.find_element_by_name(“source”)
Target = driver.find_element_by_name(“target”)
From selenium.webdriver import ActionChains
Action_chains = ActionChains(driver)
Action_chains.drag_and_drop(element, target)
3.4 在窗口和帧之间移动
在现在的web应用中很少窗口里没有任何帧。WebDriver支持使用switch_to_window方法在命名窗口里移动。
Driver.switch_to_window(“windowName”)
所有对driver的调用现在都被解释为直接到特定的窗口。但是如何知道窗口的名字?看一下打开窗口的javascript或者链接。
<a href=”somewhere.html” target=”windowName”>Click here to open a new window</a>
作为选择,你可以传一个窗口句柄给switch_to_window()方法。知道这个,就可以再每个打开的窗口之间迭代访问
For handle in driver.window_handlers:
Driver.switch_to_window(handle)
也可以在帧之间切换
Driver.switch_to_frame(“frameName”)
也可以通过用点分解路径访问子帧,可以通过指定index来确定帧。
Driver.switch_to_frame(frameName.0.child)
3.5 弹出窗口
Selenium WebDriver有对处理弹出窗口的内置支持。在你激发一个动作可以打开一个弹出窗口,你可以通过以下方式访问alert。
Alert = driver.switch_to_alert()
这将返回当前打开的警告对象。通过这个对象,你可以接受,取消,读取它的内容或甚至在提示里输入内容。这个借口在警告,确认,提示里工作的一样好。
3.6 导航:历史和定位
早先,我们使用get方法来涵盖跳转。如你所见,WebDriver有很多更小的,任务集中的接口,导航是一个很有用的任务。为了跳转到一个页面,你可以使用get方法:driver.get(“http://www.example.com”)
为了在浏览器历史里向前或向后移动:
Driver.forward()
Driver.back()
请注意这个功能完全依赖于潜在的驱动。
3.7 Cookies
Driver.get(“http://www.example.com”)
# Now set the cookie. This one is valid for the entire domain
Cookie = {“key”: “value”}
Driver.add_cookie(cookie)
# And now output all the available cookies for the current URL
All_cookies = driver.get_cookies()
For cookie_name, cookie_value in all_cookies.items():
Print “%s -> %s”, cookie_name, cookie_value
4 定位元素
有很多种在页面上定位元素的策略。你可以使用对你case最合适的那种。Selenium提供下列方法来定位页面上的元素
Find_element_by_id
Find_element_by_name
Find_element_by_xpath
Find_element_by_link_text
Find_element_by_partial_link_text
Find_element_by_tag_name
Find_element_by_class_name
Find_element_by_css_selector
发现多个元素(这些方法将返回一个列表)
Find_elements_by_name
Find_elements_by_xpath
Find_elements_by_link_text
Find_elements_by_partial_link_text
Find_elements_by_tag_name
Find_elements_by_class_name
Find_elements_by_css_selector
4.1 通过ID定位元素
当你知道元素的id属性的时候使用这个方法。通过这个策略,匹配定位的第一个具有id属性的元素将被返回,如果没有元素具有id属性,抛出NoSuchElementException。
例如,考虑下页面源文件
<html>
<body>
<form id="loginForm">
<input name="username" type="text" />
<input name="password" type="password" />
<input name="continue" type="submit" value="Login" />
</form>
</body>
<html>
Form元素可以被如此定位:login_form = driver.find_element_by_id(“loginForm”)
4.2 通过名字定位
当你知道元素的name属性的时候使用这个方法。通过这个策略,匹配定位的第一个具有name属性的元素将被返回,如果没有元素具有name属性,抛出NoSuchElementException。
例如,考虑下页面源文件
<html>
<body>
<form id="loginForm">
<input name="username" type="text" />
<input name="password" type="password" />
<input name="continue" type="submit" value="Login" />
<input name="continue" type="button" value="Clear" />
</form>
</body>
<html>
用户名和密码元素可以如下定位:
Username = driver.find_element_by_name(“username”)
Password = driver.find_element_by_name(“password”)
Continue = driver.find_element_by_name(“Continue”)
4.3 通过xpath定位
Xpath是用来在XML文档中定位节点的语言。
例如,考虑下页面源文件
<html>
<body>
<form id="loginForm">
<input name="username" type="text" />
<input name="password" type="password" />
<input name="continue" type="submit" value="Login" />
<input name="continue" type="button" value="Clear" />
</form>
</body>
<html>
Form元素可以如下定位:
Login_form = driver.find_element_by_xpath(“/html/body/form[1]”)
Login_form = driver.find_element_by_xpath(“//form[1]”)
Login_form = driver.find_element_by_xpath(“//form[@id=’loginForm’]”)
Username可以如下定位:
username = driver.find_element_by_xpath("//form[input/@name='username']")
username = driver.find_element_by_xpath("//form[@id='loginForm']/input[1]")
username = driver.find_element_by_xpath("//input[@name='username']")
4.4 通过链接文本定义超链接
<html>
<body>
<p>Are you sure you want to do this?</p>
<a href="continue.html">Continue</a>
<a href="cancel.html">Cancel</a>
</body>
<html>
Continue链接可以如下定位:
continue_link = driver.find_element_by_link_text('Continue')
continue_link = driver.find_element_by_partial_link_text('Conti')
英文原文见这里