[译]Selenium Python文档:四、元素定位

要定位一个页面中的元素有多中策略和方法。你可以根据实际情况选择其中最为合适的。Selenium为定位页面元素提供了下面的这些方法:

  • find_element_by_id(使用id)
  • find_element_by_name(使用name属性值)
  • find_element_by_xpath(使用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(使用CSS选择器)

要定位多个元素,除了通过id进行定位,只需将elements+s(这些元素将会一个列表的形式返回)

  • find_elements_by_name(使用name属性值)
  • find_elements_by_xpath(使用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(使用CSS选择器)

除了上面的通用方法外,在一个页面对象进行访问操作的时候还有两个非常有用的私有方法:find_elementfind_elements

使用样例:

from selenium.webdriver.common.by import By

driver.find_element(By.XPATH, '//button[text()="Some text"]')
driver.find_elements(By.XPATH, '//button')

By类可用的属性如下:

ID = "id"
XPATH = "xpath"
LINK_TEXT = "link text"
PARTIAL_LINK_TEXT = "partial link text"
NAME = "name"
TAG_NAME = "tag name"
CLASS_NAME = "class name"
CSS_SELECTOR = "css selector"

4.1.通过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>

usernamepassword元素可以向下面这样定位:

username = driver.find_element_by_name('username')
password = driver.find_element_by_name('password')

下面将会返回Login按钮,因为他出现在Clear按钮的前面:

continue = driver.find_element_by_name('continue')

4.3.使用XPath进行定位

XPath是一种用于定位XML文档节点的语法。因为HTML可以是一种XML实现(XHTML),Selenium用户可以使用这种强大的语言工具来定位他们页面应用的元素。XPath扩展了仅仅通过id和name属性进行元素定位的简单方法(XPath也支持),为元素定位开辟了更多的可能。比如定位页面中的第三个单选框。

当你想要定位的元素没有合适的id和name的时候,使用XPath会是一个比较好的选择。你可以使用XPath通过绝对路径或者相对路径定位没有id和name属性的元素(不推荐使用绝对路径)。除了id和name,XPath定位器也可以通过其他属性指定元素。

XPath包含一个HTML中从根节点开始所有元素的定位,所以当你单独定位一个元素失败的时候,可以稍稍做些调整,通过定位一个紧邻的带有id或name属性的元素,基于相对关系进而定位到你想要的目标元素(最好是一个父节点元素)。只需做很小的改变,你的测试脚本的鲁棒性/稳健性就会大大增强。

举个例子,考虑一下下面的页面源码:

<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']")
  1. 绝对路径(HTML只要稍微变动就会失效)
  2. HTML中的第一个form元素
  3. id属性值为loginForm的form元素

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']")
  1. 有一个input子元素,name属性为username的form元素
  2. id属性为loginForm的form元素的第一个input子元素
  3. name属性为username的第一个input元素

Clear按钮元素可以像下面这样定位:

clear_button = driver.find_element_by_xpath("//input[@name='continue'][@type='button']")
clear_button = driver.find_element_by_xpath("//form[@id='loginForm']/input[4]")
  1. name属性为continue,type属性为button的input元素
  2. id属性为loginForm的form元素的第四个input子元素

这些示例只包含一些基础使用,想要了解更详细的相关信息,推荐浏览:

也有一些优秀的浏览器插件可以用来辅助编写定位元素的XPath:

4.4.通过链接文本定位超链接

当知道一个锚点标签内使用的链接文本时可以使用本方法。此方法将会返回匹配链接文本的第一个元素。如果没有相匹配的元素,将抛出一个NoSuchElementException异常。

举个例子,考虑一下下面的网页源码:

<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.html链接可以像下面这样进行定位:

continue_link = driver.find_element_by_link_text('Continue')
continue_link = driver.find_element_by_partial_link_text('Conti')

4.5.通过标签名定位元素

当想要通过标签名定位元素时可以使用此方法。使用此方法,将会返回匹配给定标签名的第一个元素。如果没有相匹配的元素,将会抛出一个NoSuchElementException异常。

举个例子,考虑一下下面的网页源码:

<html>
 <body>
  <h1>Welcome</h1>
  <p>Site content goes here.</p>
</body>
<html>

标题元素(h1)可以像下面这样定位:

heading1 = driver.find_element_by_tag_name('h1')

4.6.通过类名定位元素

当想要通过类名(class)属性定位元素时可以使用此方法。使用此方法,将会返回匹配给类名属性的第一个元素。如果没有相匹配的元素,将会抛出一个NoSuchElementException异常。

举个例子,考虑下面的网页源码:

<html>
 <body>
  <p class="content">Site content goes here.</p>
</body>
<html>

p元素可以像下面这样进行定位:

content = driver.find_element_by_class_name('content')

4.7.使用CSS选择器定位元素

当想要使用CSS选择器语法定位元素时可以使用此方法。使用此方法,将会返回匹配给定CSS 选择器的第一个元素。如果没有相匹配的元素,将会抛出一个NoSuchElementException异常。

举个例子,考虑一下下面的网页源码:

<html>
 <body>
  <p class="content">Site content goes here.</p>
</body>
<html>

p元素可以像像下面这样进行定位:

content = driver.find_element_by_css_selector('p.content')

Sauce Labs 上有关于 CSS 选择器的优秀文档.

posted @ 2017-03-22 23:24  Tacey Wong  阅读(3157)  评论(0编辑  收藏  举报