• 标示符定位
  • ID 定位
  • Name 定位
  • XPath 定位
  • Link Text 定位超链接
  • DOM 定位
  • CSS 定位
  • 隐式定位器

    对于许多 Selenium 命令,目标是必需的。这个目标用来标示 web 应用程序内容中的指定元素,他是用 locatorType = location 格式所描述。在许多情况下定位器类型可以省略。下面逐一解释各种定位器类型的例子。

    标示符定位

    这是最常用的定位元素的方法,当没有指定定位器类型时,默认使用这种定位器。这个策略会检索 id 属性值与 location 匹配的第一个元素。如果没有元素的 id 属性与之匹配,那么会检索 name 属性与 location 匹配的第一个元素。

    例如,你的页面源代码可能有id和name属性如下:

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input name="username" type="text" />
    5. <input name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. </form>
    8. </body>
    9. <html>

    下面的定位策略将返回上面 HTML片段 中相匹配元素的行号:

    • identifier=loginForm (3)
    • identifier=password (5)
    • identifier=continue (6)
    • continue (6)

    因为 identifier 类型的定位是默认的,前三个例子的 identifier = 不是必需的。

    ID 定位

    这种类型的定位器比 identifier 定位器类型限制更多,但也更加明确。当你知道一个元素的 id 属性时使用这个定位器。

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input name="username" type="text" />
    5. <input name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. <input name="continue" type="button" value="Clear" />
    8. </form>
    9. </body>
    10. <html>
    • id=loginForm (3)

    Name 定位

    Name 定位器类型将定位与 Name 属性相匹配的第一个元素。如果有多个名称属性相同的元素,那么您可以使用过滤器来进一步完善你的位置策略。默认的过滤器类型是值(匹配 value 属性)。

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input name="username" type="text" />
    5. <input name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. <input name="continue" type="button" value="Clear" />
    8. </form>
    9. </body>
    10. <html>
    • name=username (4)
    • name=continue value=Clear (7)
    • name=continue Clear (7)
    • name=continue type=button (7)

    注意

    不像某些类型的定位器,如:XPath 和 DOM。上面三种类型的定位器允许 Selenium 测试 UI 元素不依赖与在页面上的位置。如果页面结构或者组织改变了,测试仍将通过。你可能会或可能不会对页面结构发生变化的页面进行测试。如果网页设计师经常改变页面,但其功能必须回归测试,通过 id 和 name 属性,或通过任何 HTML 属性进行测试就变得非常重要了。

    XPath 定位

    XPath 是用于定位 XML 文档中节点的语言。由于 HTML 可以实现为 XML(XHTML),Selenium 的用户可以利用这个强大的语言来定位他们 web 应用程序中的元素。XPath 超出(以及支持)简单的 id 或 name 属性定位,并开辟了各种新的可能性,如定位页面上第三方的复选框。

    使用 XPath 的主要原因之一是对于一个你希望找到的元素,你没有合适的 id 或 name 属性来定位。您可以用 XPath 绝对定位元素(不建议),或相对于一个有 id 或 name 属性的元素来定位。XPath 定位器也可以通过使用 id 和 name 属性之外的其他属性来定位元素。

    绝对的 XPath 包含从根(html)所有元素的位置,因此只要轻微的调整应用程序页面,XPath 就会失效。通过寻找附近的 id 或 name 属性的元素(理想情况下是一个父元素)可以基于这种位置关系来定位你的目标元素。这种位置关系通常不太可能改变,可以使你的测试更加健壮。

    因为只有 XPath 定位器从 // 开始,所以在指定 XPath 定位器时没有必要包含 xpath = label。

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input name="username" type="text" />
    5. <input name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. <input name="continue" type="button" value="Clear" />
    8. </form>
    9. </body>
    10. <html>
    • xpath=/html/body/form[1] (3) - 绝对路径(对 HTML 轻微的修改会令此路径失效)
    • //form[1] (3) - HTML中的第一个form 元素
    • xpath = //form[@id = ‘loginForm’] (3) - 拥有 id 属性值为 loginForm 的 element 元素
    • xpath=//form[input/@name=’username’] (3) - 拥有一个 input 子元素,该元素的 name 属性值为 username 的第一个表单元素
    • //input[@name=’username’] (4) - name 属性值为 username 的第一个 input 元素
    • //form[@id=’loginForm’]/input[1] (4) - id 为 loginForm 的表单元素的第一个 input 子元素
    • //input[@name=’continue’][@type=’button’] (7) - name 属性值为 continue 以及 type 属性值为 button 的 input 元素
    • //form[@id=’loginForm’]/input[4] (7) - id 属性值为 loginForm 的表单的第四个 input 子元素

    上面的例子都很基础,如果想更深入的学习,请参考下面的学习资料:

    • W3Schools XPath Tutorial
    • W3C XPath Recommendation

    下面是一些非常有用的火狐浏览器的插件,能辅助定位 XPath 中的元素:

    • XPath Checker - 生成 XPath 并检查 XPath 的有效性
    • Firebug - 非常强大而有用的插件, XPath 只是其中很小的功能

    用链接文字来定位网页面上的超链接元素是一个很简单的方法。如果两个链接有相同的文本,那么第一个匹配的元素被定位。

    1. <html>
    2. <body>
    3. <p>Are you sure you want to do this?</p>
    4. <a href="continue.html">Continue</a>
    5. <a href="cancel.html">Cancel</a>
    6. </body>
    7. <html>
    • link=Continue (4)
    • link=Cancel (5)

    DOM 定位

    文档对象模型用来表示一个 HTML 文档,可以使用 JavaScript 操作和访问。这个位置策略使用 JavaScript 来评估一个元素是否页面上,他通过使用分层的点号标记法,使得元素定位得到简化。

    因为只有 dom 定位器由 document 开始,所以当指定一个 DOM 定位器时没有必要包括 dom = label 。

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input name="username" type="text" />
    5. <input name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. <input name="continue" type="button" value="Clear" />
    8. </form>
    9. </body>
    10. <html>
    • dom=document.getElementById(‘loginForm’) (3)
    • dom=document.forms[‘loginForm’] (3)
    • dom=document.forms[0] (3)
    • document.forms[0].username (4)
    • document.forms[0].elements[‘username’] (4)
    • document.forms[0].elements[0] (4)
    • document.forms[0].elements[3] (7)

    您可以使用 Selenium 以及其他网站或者浏览器扩展来探索你的 web 应用程序的 DOM。W3Schools 是一个好的参考。

    CSS 定位

    CSS(Cascading Style Sheets,层叠样式表)是用于描述 HTML 和 XML 文档样式的语言。CSS 使用选择器来绑定文档中元素的样式属性。这些选择器可以使用 Selenium 作为另一个定位策略。

    1. <html>
    2. <body>
    3. <form id="loginForm">
    4. <input class="required" name="username" type="text" />
    5. <input class="required passfield" name="password" type="password" />
    6. <input name="continue" type="submit" value="Login" />
    7. <input name="continue" type="button" value="Clear" />
    8. </form>
    9. </body>
    10. <html>
    • css=form#loginForm (3)
    • css=input[name=”username”] (4)
    • css=input.required[type=”text”] (4)
    • css=input.passfield (5)
    • css=#loginForm input[type=”button”] (7)
    • css=#loginForm input:nth-child(2) (5)

    关于 CSS 选择器的更多信息,请参考 W3C publication。你会在那里找到额外的资料。

    注意

    经验丰富的 Selenium 用户推荐 CSS 作为他们的定位策略,因为 CSS 选择器速度大大快于 XPath 并且可以在一个 HTML 文档中找到最复杂的对象。

    隐式定位器

    以下三种情况你可以省略定位器类型:

    • 定位器没有明确指定定位策略的默认使用identifier 定位策略。
    • 定位器开始与 // 将使用XPath定位策略。
    • 定位器开始于 document 将使用DOM定位策略。