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

2022-11-10 16:28:00

要定位一个页面中的元素有多中策略和方法。你可以根据实际情况选择其中最为合适的。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_element和find_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>

username和password元素可以向下面这样定位：

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']")

绝对路径（HTML只要稍微变动就会失效）
HTML中的第一个form元素
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']")

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

name属性为continue，type属性为button的input元素
id属性为loginForm的form元素的第四个input子元素

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

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

XPath Checker -XPath提示，也能用于测试XPath结果
Firebug -XPath提示只是其强大功能的一部分
XPath Helper -谷歌Chrome插件

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 选择器的优秀文档.

码农公寓