Selenium 中文API.doc

Selenium 中文 API

最近研究了下 Selenium，苦于网上中文资料太少，便自己翻译了下 Selenium 官网上的

API，便于大家一起沟通和学习。

由于本人英文水平有限，部分字词句的拿捏可能不太到位，希望各位朋友给出宝贵意见哈

概念

Selenium 通过命令进行驱动。Selenium 可归纳为三种“风格”：动作、辅助和断言。每一个

命令调用就是下表中的一行。

命令

许多动作可以被包含后缀”并等待”的方式进行调用，例如,”点击并等待”。这个后缀告知

Selenium，该命令将使浏览器向服务器产生一个请求，并使得 Selenium 等待加载一个新的

页面。

辅助(Accessors)用于检查应用程序的状态并将结果存储在变量中。例如”storeTitle”。它们同

样可用于自动生成断言。

断言(Assertions)类似于辅助，但它们可以验证应用程序的状态是否同所期望的相一致。例

如包括”确认页面标题为 X”和”验证该复选框是否被勾选”。

真，他们将立即成功执行。反之，如果该条件不为真，则将失败并暂停测试，直到超过当

前所设定的超时时间(参照后面的 setTimeout 动作)。

元素定位器(Element Locators)告诉 Selenium 是向 HTML 中的哪一个元素发送命令。许多命

令 需 要 一 个 如 ” target” 属 性 的 元 素 定 位 器 。 这 其 中 包 括 ” elementId” 和 ” document.

forms[0].element”。在接下来的部分将更详细的描述它们。

更详细的描述。

定义一个类用于运行 Selenium 命令。

元素定位器(Element Locators)

元素定位器(Element Locators)告诉 Selenium 是向 HTML 中的哪一个元素发送命令。一个定

位器的格式如下：

locatorType = argument

这里的 name 可以作为可选项跟在一个或多个元素过滤器的后面，通过空格进行分隔。如

果没有指定过滤类型，则假定为 value。

〇 name=flavour value=chocolate

·dom=javascriptExpression: 通过检测指定字符串查找元素。这使得你可以通过 JavaScript 贯

穿 HTML 文档对象。注意在这个字符串中返回值不是必须的；仅仅只需要确保这条语句是

你块中的最后一条。

〇 dom=document.forms[´myForm´].myDropdown

〇 dom=function foo() { return document.links[1];}; foo();

〇 xpath=//img[@alt=´The image alt text´]

〇 xpath=//table[@id=´table1´]//tr[4]/td[2]

〇 xpath=//a[contains(@href, ´#id1´)]

〇 xpath=//a[contains(@href, ´#id1´)]/@class

〇 xpath=(//table[@class=´stylee´])//th[text()=´theHeaderText´]/../td

〇 xpath=//input[@name=´name2´ and @value=´yes´]

·link=textPattern: 选择所包含的文字匹配指定式样的链接(锚)。

〇 css=a[href=″#id3″]

〇 css=span#firstChid + span

当前 css 选择过滤器支持所有的 css1,css2,css3,除了 css3 中一些虚拟类(:nth-of-type,:nth-last-

of-type,:first-of-type,:last-of-type,:only-of-type,:visited,:hover,:active,:focus,:indeterminate) 以 及

虚拟元素(::first-line,::first-letter,::selection,::before,::after)。

如果没有一个显式的前缀，Selenium 使用以下默认写法：

·dom,用于开头为″document.″的定位器

·identifier，其他

元素过滤器(Element Filters)

元素过滤器可以同选择器一起使用，从一堆候选元素中进行筛选。它们当前仅使用

于’name’元素选择器。

过滤器看起来更像是选择器，也就是：

其有用。

选择单个元素基于其在列表中的位置(从 0 开始)。

字符串匹配 式样

有各种各样的式样语法可用于匹配字符串值：

·glob:pattern: 用″glob″去匹配一个字符串。″Glob″是一种用于命令行 shells 的代表性的有限

正则表达式语法。在一个 glob 式样中, ″*″代表任意序列字符集，而″?″则代表任意单个字符。

Glob 式样匹配整个字符串。

Selenium Actions

addLocationStrategy (strategyName, functionDefinition)

为 selenium 定义一个新的函数用于定位页面上的元素。例如，如果你定义了一个方法″foo

″,并运行了 click(″foo=blah″)，我们将运行你的函数，传递给你字符串″blah″，并点击该函数

所返回的元素，如果返回为 null，则抛出一个″Element not found″的错误。我们将给该函数

传递三个参数。

·locator: 用户传递过来的字符串

·inWindow: 当前所选中的窗体