Selenium 中文API文档

时间 2019-11-24

标签 selenium 中文 api 文档繁體版

原文原文链接

标签：javascript

转自：http://blog.csdn.net/lh9529/article/details/3946567css

概念html

Selenium 经过命令进行驱动。Selenium 可概括为三种“风格”：动做、辅助和断言。每个命令调用就是下表中的一行。java

命令css3

目标正则表达式

值shell

动做(Actions)命令通常用于操做应用程序的状态。它们经过如”点击连接”和”选择选项”的方式进行工做。若是一个动做执行失败，或是有错误，当前的测试将会中止执行。express

许多动做能够被包含后缀”并等待”的方式进行调用，例如,”点击并等待”。这个后缀告知Selenium，该命令将使浏览器向服务器产生一个请求，并使得Selenium等待加载一个新的页面。数组

辅助(Accessors)用于检查应用程序的状态并将结果存储在变量中。例如”storeTitle”。它们一样可用于自动生成断言。浏览器

断言(Assertions)相似于辅助，但它们能够验证应用程序的状态是否同所指望的相一致。例如包括”确认页面标题为X”和”验证该复选框是否被勾选”。

全部的Selenium断言能够被用于三种模式：”assert”, “verify”，和”waitfor”。例如，你能够”assertText”，”verifyText”，及”waitforText”。当”assert”失败时，该测试将终止。当”verify”失败时，该测试将继续执行，并将错误记入日志。这就容许了经过单条”assert”确保应用程序在正确的页面上，而经过一系列的”verify”断言测试表单上的区域值，标签等。

“waitfor”命令用于等待某些条件变为真(可用于Ajax应用程序的测试)。若是该条件已经为真，他们将当即成功执行。反之，若是该条件不为真，则将失败并暂停测试，直到超过当前所设定的超时时间(参照后面的setTimeout动做)。

元素定位器(Element Locators)告诉Selenium是向HTML中的哪个元素发送命令。许多命令须要一个如”target”属性的元素定位器。这其中包括”elementId”和”document. forms[0].element”。在接下来的部分将更详细的描述它们。

式样(Patterns)因为多种因素被使用着，如指定一个输入域的指望值，或识别一个选择选项。Selenium支持许多类型的式样，其中包括正则表达式，全部这些将在接下来的章节中进行更详细的描述。

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

元素定位器(Element Locators)

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

locatorType = argument

咱们支持以下写法用于定位元素：

·identifier=id :根据指定的@id属性选择元素。若是没有匹配的值，则选择第一个@name属性为id的元素。(参照后面)

·id=id :根据指定的@id属性选择元素。

·name=name :选择第一个根据指定的@name所查找到的元素。

〇　username

〇 name=username

这里的name能够做为可选项跟在一个或多个元素过滤器的后面，经过空格进行分隔。若是没有指定过滤类型，则假定为value。

〇 name=flavour value=chocolate

·dom=javascriptExpression: 经过检测指定字符串查找元素。这使得你能够经过 JavaScript贯穿HTML文档对象。注意在这个字符串中返回值不是必须的；仅仅只须要确保这条语句是你块中的最后一条。

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

〇 dom=document.images[56]

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

·xpath=xpathExpression: 经过XPath 表达式定位元素。

〇 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´]

〇 xpath=//*[text()=″right″]

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

〇 link=The link text

·css=cssSelectorSyntax: 经过css选择器选择元素。请查询CSS2 选择器，CSS3 选择器以得到更多信息。在下载下来的selenium core package中的selenium test suite 里的TestCssLocators test ,你一样能够查看到使用例子。

〇 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.″的定位器

·xpath,用于开头为″//″的定位器

·identifier，其余

元素过滤器(Element Filters)

元素过滤器能够同选择器一块儿使用，从一堆候选元素中进行筛选。它们当前仅使用于’name’元素选择器。

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

filterType=argument

所支持的元素过滤器为：

value=valuePattern

匹配元素时基于它们的值进行匹配。这在对一堆类似命名的关联按钮的筛选中显得尤为有用。

index=index

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

字符串匹配 式样

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

·glob:pattern: 用″glob″去匹配一个字符串。″Glob″是一种用于命令行shells的表明性的有限正则表达式语法。在一个glob式样中, ″*″表明任意序列字符集，而″?″则表明任意单个字符。Glob式样匹配整个字符串。

·regexp:regexp: 使用正则表达式匹配字符串。可以使用全部的JavaScript正则表达式。

若是没有指定式样前缀，Selenium假定其为″glob″式样。

Selenium Actions

addLocationStrategy (strategyName, functionDefinition)

为selenium定义一个新的函数用于定位页面上的元素。例如，若是你定义了一个方法″foo″,并运行了click(″foo=blah″)，咱们将运行你的函数，传递给你字符串″blah″，并点击该函数所返回的元素，若是返回为null，则抛出一个″Element not found″的错误。咱们将给该函数传递三个参数。

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

·inWindow: 当前所选中的窗体

·inDocument: 当前所选中的文档

若是未找到相应的元素，则函数必须返回一个null。

参数：

·strategyName – 定义的方法名；只能使用字母[a-zA-Z],不能包含空格或其余标点符号。

·functionDefinition – 在JavaScript函数中的一个定义body的字符串。

如：return inDocument.getElementById(locator);

addSelection (locator, optioLocator)

为经过使用选择定位器，在一个可多选元素中所选择的集合添加一个selection。@查看#doSelect关于选择定位器的细节。

参数：

·locator – 用于指定一个多选框的元素定位器

·optionLocator – 一个选择定位器(默认为标签)

allowNativeXpath (allow)

指定Selenium是否使用XPath的本地浏览执行(若是有可用的本地版本);若是传递的值为″false″，咱们将使用pure-JavaScript xpath 库。使用pure-JS xpath库能够提升xpath元素定位器在不一样浏览器中的一致性，但其执行速度将大大低于本地执行。

参数：

·allow – Boolean,true意味着咱们更愿意使用本地XPath;false则意味着咱们将只使用JS XPath

altKeyDown()

按下alt键并保持其按下状态，直到doAltUp()被调用或一个新的页面被加载。

altKeyUp()

释放alt键

answerOnNextPrompt (answer)

通知Selenium返回下一次JavaScript prompt[window.prompt()]所指定的回答字符串。

参数：

·answer – 对弹出的提示所给与的回答

assignId (locator,identifier)

临时为指定元素设定一个″id″属性，使你能够在未来使用其ID，以代替缓慢且更复杂的XPath。该ID将在页面重载后消失。

参数：

·locator – 指向某个元素的元素定位器

·identifier – 为指定元素做为ID使用的字符串

break()

暂停当前正在进行的测试，并等待用户按下继续按钮。这个命令对于调试很是有用，但使用时要特别当心，由于他将强制暂停自动化测试，直到用户手动操做。

check(locator)

勾选一个关联性按钮(checkbox/radio)

参数：

·locator – 一个元素定位器

chooseCancelOnNextConfirmation()

默认状况下， Selenium的重载window.confirm()函数将返回true，等同于用户手动点击OK;执行该命令后，下一次调用confirm()将返回false，等同于用户手动点击了Cancel。Selenium对后来的确认动做将继续使用默认行为，自动返回true(OK),除非/直到你为每一个确认动做明确的调用此命令。

chooseOkOnNextConfirmation()

撤销调用chooseCancelOnNextConfirmation的效果。注意，Selenium的重载window.confirm()函数一般将自动返回true，等同于用户手动点击OK，所以你没有必要使用此命令，除非因为某种缘由使你在下一次确认动做前不得不改变你先前的想法。在任意确认动做后，Selenium对后来的确认动做将继续使用默认行为，自动返回true(OK),除非/直到你为每一个确认动做明确的调用chooseCancelOnNextConfirmation()。

click(locator)

点击一个连接、按钮、多选框或单选框。若是该点击事件致使了新的页面加载(如同连接一般所做的)，将调用waitForPageToLoad。

参数：

·locator -一个元素定位器

clickAt(locator,coordString)

点击一个连接、按钮、多选框或单选框。若是该点击事件致使了新的页面加载(如同连接一般所做的)，将调用waitForPageToLoad。

参数：

·locator -一个元素定位器

·coordString – 指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

close()

模拟用户点击弹出窗体或表单标题栏上的″关闭″按钮。

controlKeyDown()

按下control键并保持其按下状态，直到doControlUp()被调用或一个新的页面被加载。

controlKeyUp()

释放control键

createCookie(nameValuePair,optionsString)

建立一个新的cookie，除非你清楚的指定该cookie的路径，不然其路径和域将与当前测试的页面相同。

参数：

·nameValuePair – 该cookie的名称和值，使用以下格式″name=value″

·optionsString – 该cookie的选项。当前支持的选项包括’path’和’max_age’。optionsString的格式为”path=/path/,max_age=60”。选项的顺序可有可无。

deleteCookie(name,path)

删除指定路径下的该名称cookie。

参数：

·name – 被删除cookie的名称

·path – 被删除cookie的路径属性

doubleClick(locator)

双击一个连接、按钮、多选框或单选框。若是该双击事件致使了新的页面加载(如同连接一般所做的)，将调用waitForPageToLoad。

参数：

·locator - 一个元素定位器

doubleClickAt(locator,coordString)

双击一个连接、按钮、多选框或单选框。若是该双击事件致使了新的页面加载(如同连接一般所做的)，将调用waitForPageToLoad。

参数：

·locator - 一个元素定位器

·coordString – 指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

dragAndDrop(locator,movementsString)

拖动元素必定的距离并放下

参数：

·locator - 一个元素定位器

·movementsString – 从当前位置到指定位置的像素偏移量，如,”+70,-300”

dragAndDropToObject(locatorOfObjectToBeDragged,locatorOfDragDestinationObject)

拖动元素到另外一元素

参数：

·locatorOfObjectToBeDragged – 被拖动的元素

·locatorOfDragDestinationObject – 被拖动的元素将拖向的元素的坐标 (如，其最中心像素)

Dragdrop(locator,movementsString)

不建议 – 用dragAndDrop 代替

参数：

·locator - 一个元素定位器

·movementsString – 从当前位置到指定位置的像素偏移量，如,”+70,-300”

Echo(message)

打印指定消息到你的Selenese 表的第三个表单元。有利于调试。

参数：

·message – 要打印的消息

fireEvent(locator,eventName)

明确地模拟一个事件，触发”onevent”响应句柄。

参数：

·locator - 一个元素定位器

·eventName – 事件名，如”focus” 或”blur”

getSpeed()

获取执行速度(也就是，获取接下来的每个selenium操做的延迟豪秒长度)。默认状况下，是不会有延迟的。也就是延迟为0毫秒。参照setSpeed。

goBack()

模拟用户点击其浏览器上的”back”按钮

highlight(locator)

暂时将指定元素的背景色改变为黄色。有利于调试。

参数：

·locator - 一个元素定位器

keyDown(locator,keySequence)

模拟用户按下一个键(除了还没释放的)

参数：

·locator - 一个元素定位器

·keySequence – 能够是个字符串(“/”后跟随要被按下键的数字键码，一般是该键的ASCII值)，或是个单字符，如“w“, “/119“。

keyPress(locator,keySequence)

模拟用户按下和释放一个键。

参数：

·locator - 一个元素定位器

·keySequence – 能够是个字符串(“/”后跟随要被按下键的数字键码，一般是该键的ASCII值)，或是个单字符，如“w“, “/119“。

keyUp(locator,keySequence)

模拟用户释放一个键。

参数：

·locator - 一个元素定位器

·keySequence – 能够是个字符串(“/”后跟随要被按下键的数字键码，一般是该键的ASCII值)，或是个单字符，如“w“, “/119“。

metaKeyDown()

按下meta键并保持其按下状态，直到doMetaUp()被调用或一个新的页面被加载。

metaKeyUp()

释放meta键

mouseDown(locator)

模拟用户在指定元素上按下鼠标按钮(除了还没释放的)。

参数：

·locator - 一个元素定位器

mouseDownAt(locator,coordString)

模拟用户在指定位置上按下鼠标按钮(除了还没释放的)。

参数：

·locator - 一个元素定位器

·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

mouseMove(locator)

模拟用户在指定元素上按下鼠标按钮(除了还没释放的)。

参数：

·locator - 一个元素定位器

mouseMoveAt(locator,coordString)

模拟用户在指定位置上按下鼠标按钮(除了还没释放的)。

参数：

·locator - 一个元素定位器

·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

mouseOut(locator)

模拟用户从指定元素上移开鼠标指针。

参数：

·locator - 一个元素定位器

mouseOver(locator)

模拟用户鼠标滑过指定元素。

参数：

·locator - 一个元素定位器

mouseUp(locator)

模拟用户在指定元素上释放鼠标按钮时发生的事件(也就是，中止保持按钮按下)。

参数：

·locator - 一个元素定位器

mouseUpAt(locator,coordString)

模拟用户在指定元素上释放鼠标按钮时发生的事件(也就是，中止保持按钮按下)。

参数：

·locator - 一个元素定位器

·coordString -指定由定位器返回的鼠标事件相关联的元素x,y 坐标(也就是 – 10,20)

open(url)

在测试框架中打开一个URL，能够为相对和绝对URLs。”open”命令将等待页面加载完成才继续进行，也就是明确的指名”并等待”后缀。注意：因为浏览器安全策略(相同来源方针)这个URL必须和当前运行的HTML在相同的域。若是你不得不在另外一个域打开一个URL，则须要用Selenium服务在另外一个域去打开一个新的浏览器会话。

参数：

·url – 要打开的URL,能够为空

·windowID – 要选择窗体的JavaScript window ID

pause(waitTime)

等待指定时间(以毫秒为单位)

参数：

·waitTime – 要睡眠的时间(以毫秒为单位)

refresh()

模拟用户点击浏览器上的”Refresh”按钮。

removeAllSelections(locator)

取消全部可多选元素的选择状态。

参数：

·locator – 一个用于识别多选框的元素定位器

removeSelection(locator,optionLocator)

从用选项定位器进行筛选的多选元素的筛选集合中移除一个集合。@在#doSelect中查看选项定位器的详细信息。

参数：

·locator – 一个用于识别多选框的元素定位器

·optionLocator – 一个选项定位器(默认为一个标签)

runScript(script)

在当前测试窗体的body中建立一个新的”script”标签，并在body中添加指定的命令文本。用这种方式执行脚本，一般能够比使用Selenium的”getEval”方式更简易的进行调试。要注意的是，由这种脚本标签所抛出的异常不受Selenium管理，所以当该脚本有可能会抛出异常时，你须要用try/catch块将其包含起来。

·script – 须要执行的JavaScript 片断

select(selectLocator,optionLocator)

用选项选择器从一个下拉框中选择一个选项。

选项选择器提供不一样的方法从一个HTML选择元素中识别选项。(例如：选择一个指定选项，或断言一个知足某种规范的选项)有许多种形式的选择选项定位器。

·label=labelPattern: 基于其标签匹配选项，如其有效文本。(默认)

〇 label=regexp:^[Oo]ther

·value=valuePattern: 基于其值匹配选项。

〇 value=other

·id=id: 基于其id匹配选项。

〇 id=option1

·index=index: 基于其索引匹配选项(从0开始)。

〇index=2

若是没有为选项定位器提供前缀，则默认匹配为标签行为。

参数：

·selectLocator – 一个用于识别下拉菜单的元素定位器

·optionLocator – 一个选项选择器(默认为标签)

selectFrame(locator)

在当前窗体中选择一个框架(你能够屡次调用这个命令用于选择嵌套框架)。要选择父框架，用”relative=parent”做为定位器；要选择顶级框架，用”relative=top”。你一样能够经过基于0的索引号选择框架；用”index=0”选择第一个框架，或者用”index=2”选择第三个框架。

你一样能够直接使用一个DOM表达式来识别你要的框架。像这样：dom=frames[“main”].frames[“subframe”]

参数：

·locator – 一个用于识别框架或子框架的元素定位器

selectWindow(windowID)

选择一个弹出窗体；一旦一个弹出窗体被选中，全部的命令将指向该窗体。要再次选择主窗体，将对象设定为null。

注意：window的内在JavaScript的”name”属性和被给与的window文档(一般是你实际看到的，做为最终用户，在窗体的标题栏上)的”title”之间有一个很大的不一样。”name”对于最终用户一般是不可见的；它是做为第二个参数”windowName”传递给JavaScript函数window.open(url,windowName,windowFeatures,replaceFlag)(被Selenium截取)。

Selenium有许多方法用于查找被”windowID”参数所说起的窗体对象。

1.) 若是windowID为null，(或是字符串”null”)，则假定为用户是提交给由浏览器最初实例化的窗体。

2.) 若是”windowID”参数的值是当前应用窗体的一个JavaScript变量名，则假定该变量包含一个由调用JavaScript window.open()函数所产生的返回值。

3.) 另外，selenium looks in a hash it maintains that maps string names to window “names”.

4.) 若是失败了，咱们将循环遍历全部已知的窗体以便试图找出适合的”title”。因为”title”不是必须惟一，所以可能会产生一些非指望的行为。

若是很难断定你所要操做的窗体的名称，你能够查看为识别经过window.open(被Selenium截取)所打开窗体的名称时所产生的selenium 日志消息。在每一个窗体被打开时，你一般能够看到以下信息：

debug: window.open call intercepted; window ID (你能够用于 selectWindow()) is “myNewWindow”

在某些状况，Selenium会没法截取window.open的调用(例如，若是该调用发生在”onLoad”事件之间或以前)。(该BUG标记为SEL-339)。在这些状况，你可使用Selenium的openWindow命令强制Selenium去通告打开窗体的名称，使用一个空(blank) url，像这样：openWindow(“”,”myFunnyWindow”)。

参数：

·windowID – 要选择窗体的JavaScript 窗体ID

setBrowserLogLevel(logLevel)

设定浏览器方日志信息级别；在此级别之下的日志信息将被丢弃。有效的日志级别字符串有：”debug”，”info”，”warn”，”error”，或”off”。要查看浏览器日志，在GUI模式下打开日志窗口，或在Selenium RC中将浏览器端记入日志设定为enable。

参数：

·logLevel – 如下之一：”debug”，”info”，”warn”，”error”，或”off”

setCursorPosition(locator,position)

将文本光标移动到被给与的输入元素或文本域的指定位置。若指定元素不是一个可输入元素或文本域，该方法将失败。

参数：

·locator – 一个指向输入元素或文本域的元素定位器

·position – 该范围的光标数字位置；position若是设定为0，则为该范围域的最开始位置，你一样能够将光标设定为-1以移动到该范围域的最末端。

setMouseSpeed(pixels)

配置在dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)。

将这个值设定为0，意味着咱们将向从开始位置到结束位置的每个像素发送一个”mousemove”事件；那将会很是缓慢，且可能致使某些浏览器将该JavaScript强制设定为超时。

若是该鼠标速度大于两个拖动对象间的距离，咱们将只向开始位置和结束位置发送一个”mousemove”事件。

参数：

·pixels – 两个“mousemove”事件间的像素间隔

setSpeed(value)

设定执行速度(也就是说，设定将要执行的每条selenium操做间的毫秒延迟间隔长度)。默认状况下，没有延迟，也就是延迟为0毫秒。

参数：

·value – 在操做后的暂停毫秒数

setTimeout(timeout)

指定Selenium等待动做完成的等待时间。

须要等待的动做包括”open”和”waitFor*”。

默认超时为30秒。

参数：

·timeout – 以毫秒为单位，超事后该命令将返回错误。

shiftKeyDown()

按下shift键，并保持按下状态，直到doShiftUp()被调用或一个新的页面被加载。

shiftKeyUp()

释放shift键。

store(expression,variableName)

该命令是存储表达式的同义词。

参数：

·expression – 要存储的值

·variableName – 用于存储结果的变量名

submit(formLocator)

提交给指定表单。这对于没有提交按钮的表单特别有用，如，简单输入的”search”表单。

参数：

·formLocator – 一个指向你要提交的表单的元素定位器

type(locator,value)

设定一个输入域的值，如同你输入进去同样。

其一样可用于单选框，多选框等。在这些状况，value应为选项选择时的值，而不是有效文本。

参数：

·locator – 一个元素定位器

·value – 要录入的值

typeKeys(locator,value)

模拟在指定元素上的按键事件，如同是你一个键一个键敲上去同样。

比起为指定字符串的每一个字符调用keyDown,keyUp,keyPress方法，这个函数要方便的多；其对于须要明确按键事件的动态UI组件(如自动完成的combo box)一样有用。

不一样于简单的”敲打”命令——将指定值直接强制赋给页面，该指令可能有，也可能没有任何效果，即时在敲打按钮一般会有效的状况下。例如，若是你在一个表单元素上使用”typeKeys”，你可能能够，也可能不能够看到看到你在该区域录入的效果。

在有些时候，你可能不得不使用简单的”type”命令去设定域的值，而后用”typeKeys”命令去发送按键事件以告知你所录入的值。

参数：

·locator – 一个元素定位器

·value – 要录入的值

uncheck(locator)

取消选中一个关联性按钮(checkbox/radio)

参数：

·locator – 一个元素定位器

waitForCondition(script,timeout)

重复执行指定JavaScript片断直到其值为”true”。

该片断能够有多行，但只考虑其最后一行的结果。

要注意：默认状况下，该片断会在运行者的测试窗体运行，而不是在你的应用程序窗体。要获得你的应用程序窗体，你可使用JavaScript片断selenium.browserbot.getCurrentWindow()，而后让你的JavaScript在那运行。

参数：

·script – 要运行的JavaScript片断

·timeout –以毫秒为单位，超事后该命令将返回错误。

waitForFrameToLoad(frameAddress,timeout)

等待一个新的框架加载。

Selenium一般会持续跟踪新页面和框架的加载状态，当其第一次注意到页面加载完成，将会设定一个”newPageLoaded”标志。

查看waitForPageToLoad得到更多信息。

参数：

·frameAddress – 服务端的框架地址

·timeout - 以毫秒为单位，超事后该命令将返回错误。

waitForPageToLoad(timeout)

等待一个新的页面加载。

你可使用此命令以代替”AndWait”后缀，”clickAndWait”，”selectAndWait”，”typeAndWait”等(仅在JS API中有效)。

Selenium一般会持续跟踪新页面的加载状态，当其第一次注意到页面加载完成，将会设定一个”newPageLoaded”标志。当此标志变为false后再运行其余Selenium命令。所以，若是你要等待一个页面加载完成，当一个Selenium命令致使一个页面加载后就需当即开始等待。

参数：

·timeout - 以毫秒为单位，超事后该命令将返回错误。

waitForPopUp(windowID,timeout)

等待一个弹出窗体出现和加载。

参数：

·windowID – 将出现窗体的JavaScript 窗体ID

·timeout - 以毫秒为单位，超事后该命令将返回错误。

windowFocus()

将焦点赋给当前选择窗体

windowMaximize()

从新设定当前窗体大小为全屏

Selenium Accessors

assertErrorOnNext(message)

告诉Selenium在下一个命令执行时期待有错误。

参数：

·message – 咱们所指望的错误信息。若是出现不正确的错误信息，该命令将失败。

同断言相关联，自动生成：

·assertNotErrorOnNext(message)

·verifyErrorOnNext(message)

·verifyNotErrorOnNext(message)

·waitForErrorOnNext(message)

·waitForNotErrorOnNext(message)

assertFailureOnNext(message)

告诉Selenium在下一个命令执行时期待有失败。

参数：

·message – 咱们所指望的失败信息。若是出现不正确的失败信息，该命令将失败。

同断言相关联，自动生成：

·assertNotFailureOnNext(message)

·verifyFailureOnNext(message)

·verifyNotFailureOnNext(message)

·waitForFailureOnNext(message)

·waitForNotFailureOnNext(message)

assertSelected(selectLocator,optionLocator)

验证从下拉框中选择的选项知足选项指定器。

注意，不同意使用该命令；你应该使用assertSelectedLabel, assertSelectedValue, assertSelectedIndex,或assertSelectedId进行代替。

查看选择命令获取更多关于选择定位器的信息。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·optionLocator – 一个选项定位器，表明性的就是一个选项标签(如”John Smith”)

同断言相关联，自动生成：

·assertNotSelected(selectLocator,optionLocator)

·verifySelected(selectLocator,optionLocator)

·verifyNotSelected(selectLocator,optionLocator)

·waitForSelected(selectLocator,optionLocator)

·waitForNotSelected(selectLocator,optionLocator)

storeAlert(variableName)

返回在以前动做所产生的JavaScript警告消息，若是没有警告将失败。

获得一个警告同手动点击OK有着相同的效果。若是产生了一个警告，而你并不去获得/验证它，那么下一个Selenium动做将失败。

注意：在Selenium中，JavaScript警告将不会弹出一个可见的警告对话框。

注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript警告。在这种状况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。

Returns:

最近JavaScript的警告消息

同断言相关联，自动生成：

·assertAlert(pattern)

·assertNotAlert(pattern)

·verifyAlert(pattern)

·verifyNotAlert(pattern)

·waitForAlert(pattern)

·waitForNotAlert(pattern)

storeAllButtons(variableName)

返回页面上全部按钮的ID集。

若是被给与的按钮没有ID，则将在结果数组中显示为””。

Returns:

页面上全部按钮的ID集。

同断言相关联，自动生成：

·assertAllButtons(pattern)

·assertNotAllButtons(pattern)

·verifyAllButtons(pattern)

·verifyNotAllButtons(pattern)

·waitForAllButtons(pattern)

·waitForNotAllButtons(pattern)

storeAllFields(variableName)

返回页面上全部可输入域的ID集。

若是被给与的域没有ID，则将在结果数组中显示为””

Returns:

页面上全部域的ID集。

同断言相关联，自动生成：

·assertAllFields(pattern)

·assertNotAllFields (pattern)

·verifyAllFields (pattern)

·verifyNotAllFields (pattern)

·waitForAllFields (pattern)

·waitForNotAllFields (pattern)

storeAllLinks(variableName)

返回页面上全部连接的ID集。

若是被给与的连接没有ID，则将在结果数组中显示为””

Returns:

页面上全部连接的ID集。

同断言相关联，自动生成：

·assertAllLinks(pattern)

·assertNotAllLinks (pattern)

·verifyAllLinks (pattern)

·verifyNotAllLinks (pattern)

·waitForAllLinks (pattern)

·waitForNotAllLinks (pattern)

storeAllWindowIds(variableName)

返回全部浏览器已知的窗体ID集。

Returns:

全部浏览器已知的窗体ID集。

同断言相关联，自动生成：

·assertAllWindowIds (pattern)

·assertNotAllWindowIds (pattern)

·verifyAllWindowIds (pattern)

·verifyNotAllWindowIds (pattern)

·waitForAllWindowIds (pattern)

·waitForNotAllWindowIds (pattern)

storeAllWindowNames(variableName)

返回全部浏览器已知的窗体名称集。

Returns:

全部浏览器已知的窗体名称集。

同断言相关联，自动生成：

·assertAllWindowNames (pattern)

·assertNotAllWindowNames (pattern)

·verifyAllWindowNames (pattern)

·verifyNotAllWindowNames (pattern)

·waitForAllWindowNames (pattern)

·waitForNotAllWindowNames (pattern)

storeAllWindowTitles(variableName)

返回全部浏览器已知的窗体标题集。

Returns:

全部浏览器已知的窗体标题集。

同断言相关联，自动生成：

·assertAllWindowTitles (pattern)

·assertNotAllWindowTitles (pattern)

·verifyAllWindowTitles (pattern)

·verifyNotAllWindowTitles (pattern)

·waitForAllWindowTitles (pattern)

·waitForNotAllWindowTitles (pattern)

storeAttribute(attributeLocator,variableName)

得到一个元素属性值。

参数：

·attributeLocator – 由@符号开头，后跟随属性名，如”foo@bar”

·variableName – 用于存储结果的变量名。

Returns:

指定属性的值

同断言相关联，自动生成：

·assertAttribute (attributeLocator, pattern)

·assertNotAttribute (attributeLocator, pattern)

·verifyAttribute (attributeLocator, pattern)

·verifyNotAttribute (attributeLocator, pattern)

·waitForAttribute (attributeLocator, pattern)

·waitForNotAttribute (attributeLocator, pattern)

storeAttributeFromAllWindows(attributeName,variableName)

返回全部已知窗体的某些属性的每个实例。

参数：

·attributeName – 窗体某属性的名称

·variableName - 用于存储结果的变量名。

Returns:

从全部已知窗体得到的该属性的数值集。

同断言相关联，自动生成：

·assertAttributeFromAllWindows (attributeName, pattern)

·assertNotAttributeFromAllWindows (attributeName, pattern)

·verifyAttributeFromAllWindows (attributeName, pattern)

·verifyNotAttributeFromAllWindows (attributeName, pattern)

·waitForAttributeFromAllWindows (attributeName, pattern)

·waitForNotAttributeFromAllWindows (attributeName, pattern)

storeBodyText(variableName)

获取页面上全部文本。

Returns:

页面上全部文本

同断言相关联，自动生成：

·assertBodyText (pattern)

·assertNotBodyText (pattern)

·verifyBodyText (pattern)

·verifyNotBodyText (pattern)

·waitForBodyText (pattern)

·waitForNotBodyText (pattern)

storeConfirmation(variableName)

返回在以前动做所产生的JavaScript确认消息。

默认状况下，confirm函数将返回true，同手动点击OK有着相同的效果。这能够经过以前执行chooseCancelOnNextConfirmation命令改变。若是产生了一个确认，而你并不去获得/验证它，那么下一个Selenium动做将失败。

注意：在Selenium中，JavaScript确认将不会弹出一个可见的对话框。

注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript警告。在这种状况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。

Returns:

最近JavaScript的确认消息

同断言相关联，自动生成：

·assertConfirmation (pattern)

·assertNotConfirmation (pattern)

·verifyConfirmation (pattern)

·verifyNotConfirmation (pattern)

·waitForConfirmation (pattern)

·waitForNotConfirmation (pattern)

storeCookie(variableName)

返回当前测试下当前页面的全部cookies

Returns:

当前测试下当前页面的全部cookies

同断言相关联，自动生成：

·assertCookie (pattern)

·assertNotCookie (pattern)

·verifyCookie (pattern)

·verifyNotCookie (pattern)

·waitForCookie (pattern)

·waitForNotCookie (pattern)

storeCursorPosition(locator,variableName)

返回所给与的输入元素或文本域的文本光标位置。

要注意，这并不在全部的浏览器中有效。

特别指出，若是光标/选择已经被JavaScript所清除，该命令将尝试返回光标所在的最后位置，即便光标已经不在该页面。这被归档为SEL-243。

若是指定元素不是一个可输入元素或文本域，或没有光标在此元素上，该方法将失败。

参数：

·locator – 一个指向输入元素或文本域的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

在该域中的光标数字位置

同断言相关联，自动生成：

·assertCursorPosition (locator,pattern)

·assertNotCursorPosition (locator,pattern)

·verifyCursorPosition (locator,pattern)

·verifyNotCursorPosition (locator,pattern)

·waitForCursorPosition (locator,pattern)

·waitForNotCursorPosition (locator,pattern)

storeElementHeight(locator,variableName)

返回元素的高度

参数：

·locator – 一个指向元素的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

元素的高度

同断言相关联，自动生成：

·assertElementHeight (locator,pattern)

·assertNotElementHeight (locator,pattern)

·verifyElementHeight (locator,pattern)

·verifyNotElementHeight (locator,pattern)

·waitForElementHeight (locator,pattern)

·waitForNotElementHeight (locator,pattern)

storeElementIndex(locator,variableName)

获取元素相对于其父元素的索引(从0开始)。注释节点和空文本节点将被忽略。

参数：

·locator – 一个指向元素的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

元素相对于其父元素的索引(从0开始)

同断言相关联，自动生成：

·assertElementIndex (locator,pattern)

·assertNotElementIndex (locator,pattern)

·verifyElementIndex (locator,pattern)

·verifyNotElementIndex (locator,pattern)

·waitForElementIndex (locator,pattern)

·waitForNotElementIndex (locator,pattern)

storeElementPositionLeft(locator,variableName)

返回元素的水平位置

参数：

·locator – 一个指向元素的元素定位器或元素自己

·variableName - 用于存储结果的变量名。

Returns:

到框架边缘的像素。

同断言相关联，自动生成：

·assertElementPositionLeft (locator,pattern)

·assertNotElementPositionLeft (locator,pattern)

·verifyElementPositionLeft (locator,pattern)

·verifyNotElementPositionLeft (locator,pattern)

·waitForElementPositionLeft (locator,pattern)

·waitForNotElementPositionLeft (locator,pattern)

storeElementPositionTop(locator,variableName)

返回元素的纵向位置

参数：

·locator – 一个指向元素的元素定位器或元素自己

·variableName - 用于存储结果的变量名。

Returns:

到框架边缘的像素。

同断言相关联，自动生成：

·assertElementPositionTop (locator,pattern)

·assertNotElementPositionTop (locator,pattern)

·verifyElementPositionTop (locator,pattern)

·verifyNotElementPositionTop (locator,pattern)

·waitForElementPositionTop (locator,pattern)

·waitForNotElementPositionTop (locator,pattern)

storeElementWidth(locator,variableName)

返回元素的宽度

参数：

·locator – 一个指向元素的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

元素的宽度(以像素为单位)

同断言相关联，自动生成：

·assertElementWidth (locator,pattern)

·assertNotElementWidth (locator,pattern)

·verifyElementWidth (locator,pattern)

·verifyNotElementWidth (locator,pattern)

·waitForElementWidth (locator,pattern)

·waitForNotElementWidth (locator,pattern)

storeEval(script,variableName)

得到指定JavaScript片断执行后的值。该片断能够有多行，但只返回最后一行的值。要注意到，默认状况下，该片断将在”selenium”对象自己的上下文中运行，所以其将提交给Selenium对象。用window将窗体提交给你的应用程序，如：

window.document.getElementById(‘foo’)

若是你不得不在你的应用程序页面使用一个定位器提交一个单元素，你能够用this.browserbot.findElement(“id=foo”)，这里”id=foo”就是你的定位器。

参数：

·script – 要运行的JavaScript

·variableName - 用于存储结果的变量名。

Returns:

片断执行后的值

同断言相关联，自动生成：

·assertEval (script,pattern)

·assertNotEval (script,pattern)

·verifyEval (script,pattern)

·verifyNotEval (script,pattern)

·waitForEval (script,pattern)

·waitForNotEval (script,pattern)

storeExpression(expression,variableName)

返回指定表达式。

因为JavaScript的预处理机制使其显得很是有用。它能够用于生成如assertExpression和waitForExpression命令。

参数：

·expression – 要返回的值

·variableName - 用于存储结果的变量名。

Returns:

经过的值

同断言相关联，自动生成：

·assertExpression (expression,pattern)

·assertNotExpression (expression,pattern)

·verifyExpression (expression,pattern)

·verifyNotExpression (expression,pattern)

·waitForExpression (expression,pattern)

·waitForNotExpression (expression,pattern)

storeHtmlSource(variableName)

返回”html”标签间的整个HTML源代码。

Returns:

整个HTML源代码

同断言相关联，自动生成：

·assertHtmlSource (pattern)

·assertNotHtmlSource (pattern)

·verifyHtmlSource (pattern)

·verifyNotHtmlSource (pattern)

·waitForHtmlSource (pattern)

·waitForNotHtmlSource (pattern)

storeLocation(variableName)

取得当前页面的绝对路径

Returns:

当前页面的绝对路径

同断言相关联，自动生成：

·assertLocation (pattern)

·assertNotLocation (pattern)

·verifyLocation (pattern)

·verifyNotLocation (pattern)

·waitForLocation (pattern)

·waitForNotLocation (pattern)

storeMouseSpeed(variableName)

返回在dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)

Returns:

dragAndDrop 命令执行期间，”mousemove”事件时的像素数字(默认为10)

同断言相关联，自动生成：

·assertMouseSpeed (pattern)

·assertNotMouseSpeed (pattern)

·verifyMouseSpeed (pattern)

·verifyNotMouseSpeed (pattern)

·waitForMouseSpeed (pattern)

·waitForNotMouseSpeed (pattern)

storePrompt(variableName)

返回在以前动做所产生的JavaScript问题提示消息。

要成功挂起问题提示须要先运行answerOnNextPrompt命令。若是产生了一个问题提示，而你并不去获得/验证它，那么下一个Selenium动做将失败。

注意：在Selenium中，JavaScript确认将不会弹出一个可见的对话框。

注意：Selenium不支持在页面的onload()事件句柄中所产生的JavaScript问题提示。在这种状况下，将会生成一个可见的对话框，Selenium将被悬停直到手动点击OK。

Returns:

最近JavaScript的问题提示消息

同断言相关联，自动生成：

·assertPrompt (pattern)

·assertNotPrompt (pattern)

·verifyPrompt (pattern)

·verifyNotPrompt (pattern)

·waitForPrompt (pattern)

·waitForNotPrompt (pattern)

storeSelectedId(selectLocator,variableName)

获取从指定选择元素中选择的选项元素ID。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

从指定选择元素中选择的选项元素ID

同断言相关联，自动生成：

·assertSelectedId (selectLocator,pattern)

·assertNotSelectedId (selectLocator,pattern)

·verifySelectedId (selectLocator,pattern)

·verifyNotSelectedId (selectLocator,pattern)

·waitForSelectedId (selectLocator,pattern)

·waitForNotSelectedId (selectLocator,pattern)

storeSelectedIds(selectLocator,variableName)

从指定选择或多选元素中获取选择的选项元素ID集。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

从指定选择或多选元素中选择的选项元素ID集合数组

同断言相关联，自动生成：

·assertSelectedIds (selectLocator,pattern)

·assertNotSelectedIds (selectLocator,pattern)

·verifySelectedIds (selectLocator,pattern)

·verifyNotSelectedIds (selectLocator,pattern)

·waitForSelectedIds (selectLocator,pattern)

·waitForNotSelectedIds (selectLocator,pattern)

storeSelectedIndex(selectLocator,variableName)

从指定的选择元素中获取被选项索引(从0开始)。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

从指定选择元素中选择的选项元素索引

同断言相关联，自动生成：

·assertSelectedIndex (selectLocator,pattern)

·assertNotSelectedIndex (selectLocator,pattern)

·verifySelectedIndex (selectLocator,pattern)

·verifyNotSelectedIndex (selectLocator,pattern)

·waitForSelectedIndex (selectLocator,pattern)

·waitForNotSelectedIndex (selectLocator,pattern)

storeSelectedIndexs(selectLocator,variableName)

从指定的选择或多选元素中获取被选项索引(从0开始)集。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

从指定选择或多选元素中选择的选项元素索引集合数组

同断言相关联，自动生成：

·assertSelectedIndexs (selectLocator,pattern)

·assertNotSelectedIndexs (selectLocator,pattern)

·verifySelectedIndexs (selectLocator,pattern)

·verifyNotSelectedIndexs (selectLocator,pattern)

·waitForSelectedIndexs (selectLocator,pattern)

·waitForNotSelectedIndexs (selectLocator,pattern)

storeSelectedLabel(selectLocator,variableName)

从指定的选择元素中获取所选择的选项标签(可见文本)。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

所选择的选项标签

同断言相关联，自动生成：

·assertSelectedLabel (selectLocator,pattern)

·assertNotSelectedLabel (selectLocator,pattern)

·verifySelectedLabel (selectLocator,pattern)

·verifyNotSelectedLabel (selectLocator,pattern)

·waitForSelectedLabel (selectLocator,pattern)

·waitForNotSelectedLabel (selectLocator,pattern)

storeSelectedLabels(selectLocator,variableName)

从指定的选择或多选元素中获取所选择的选项标签(可见文本)。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

所选择的选项标签

同断言相关联，自动生成：

·assertSelectedLabel (selectLocator,pattern)

·assertNotSelectedLabel (selectLocator,pattern)

·verifySelectedLabel (selectLocator,pattern)

·verifyNotSelectedLabel (selectLocator,pattern)

·waitForSelectedLabel (selectLocator,pattern)

·waitForNotSelectedLabel (selectLocator,pattern)

storeSelectedValue(selectLocator,variableName)

从指定的选择元素中获取所选择的选项值(值属性)。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

所选择的选项值

同断言相关联，自动生成：

·assertSelectedValue (selectLocator,pattern)

·assertNotSelectedValue (selectLocator,pattern)

·verifySelectedValue (selectLocator,pattern)

·verifyNotSelectedValue (selectLocator,pattern)

·waitForSelectedValue (selectLocator,pattern)

·waitForNotSelectedValue (selectLocator,pattern)

storeSelectedValues(selectLocator,variableName)

从指定的选择或多选元素中获取全部所选择的选项值(值属性)。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

全部所选择的选项值数组

同断言相关联，自动生成：

·assertSelectedValues (selectLocator,pattern)

·assertNotSelectedValues (selectLocator,pattern)

·verifySelectedValues (selectLocator,pattern)

·verifyNotSelectedValues (selectLocator,pattern)

·waitForSelectedValues (selectLocator,pattern)

·waitForNotSelectedValues (selectLocator,pattern)

storeSelectOptions(selectLocator,variableName)

获取指定选择下拉框的选项标签。

参数：

·selectLocator - 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

指定选择下拉框的选项标签数组

同断言相关联，自动生成：

·assertSelectedOptions (selectLocator,pattern)

·assertNotSelectedOptions (selectLocator,pattern)

·verifySelectedOptions (selectLocator,pattern)

·verifyNotSelectedOptions (selectLocator,pattern)

·waitForSelectedOptions (selectLocator,pattern)

·waitForNotSelectedOptions (selectLocator,pattern)

storeTable(tableCellAddress,variableName)

从某个表的单元格中获取文本。单元格地址语法如tablelocator.row.column，这里的row和column从0开始。

参数：

·tableCellAddress – 一个单元格地址，如”foo.1.4”

·variableName -用于存储结果的变量名。

Returns:

从指定单元格取出的文本

同断言相关联，自动生成：

·assertTable (tableCellAddress,pattern)

·assertNotTable (tableCellAddress,pattern)

·verifyTable (tableCellAddress,pattern)

·verifyNotTable (tableCellAddress,pattern)

·waitForTable (tableCellAddress,pattern)

·waitForNotTable (tableCellAddress,pattern)

storeText(locator,variableName)

获取元素的文本。这对任何包含文本的元素都有效。该命令便可以用于如火狐浏览器的textContent，也能够用于如IE浏览器的innerText——显示给用户的。

参数：

·locator - 一个元素定位器

·variableName - 用于存储结果的变量名。

Returns:

元素的文本

同断言相关联，自动生成：

·assertText (locator,pattern)

·assertNotText (locator,pattern)

·verifyText (locator,pattern)

·verifyNotText (locator,pattern)

·waitForText (locator,pattern)

·waitForNotText (locator,pattern)

storeTitle(variableName)

获取当前页面的标题。

Returns:

当前页面的标题。

同断言相关联，自动生成：

·assertTitle (pattern)

·assertNotTitle (pattern)

·verifyTitle (pattern)

·verifyNotTitle (pattern)

·waitForTitle (pattern)

·waitForNotTitle (pattern)

storeValue(locator,variableName)

得到一个输入域(或任何包含value参数的元素)的值(已去除空格)。对于checkbox/radio元素，其值为”on”仍是”off”依赖于该元素是否被选中。

参数：

·locator - 一个元素定位器

·variableName - 用于存储结果的变量名。

Returns:

元素值，对于checkbox/radio元素则为”on/off”

同断言相关联，自动生成：

·assertValue (locator,pattern)

·assertNotValue (locator,pattern)

·verifyValue (locator,pattern)

·verifyNotValue (locator,pattern)

·waitForValue (locator,pattern)

·waitForNotValue (locator,pattern)

storeWhetherThisFrameMatchFrameExpression(currenFrameString,target,variableName)

肯定当前框架是否包含该运行代码。

这对于代理注入代码模式很是有用，这些代码在每一个浏览器框架和窗体中运行，有时selenium server须要识别当前是哪一个框架。这种状况下，当测试调用selectFrame，该程序将被每一个框架调用以指出哪一个框架被选择。被选择的框架将返回true，而其余将返回false。

参数：

·currenFrameString – 开始框架

·target – 新框架(也许与当前框架相关联)

·variableName -用于存储结果的变量名。

Returns:

若是新框架为该代码的窗体，返回true

同断言相关联，自动生成：

·assertWhetherThisFrameMatchFrameExpression (currenFrameString, target)

·assertNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

·verifyWhetherThisFrameMatchFrameExpression (currenFrameString, target)

·verifyNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

·waitForWhetherThisFrameMatchFrameExpression (currenFrameString, target)

·waitForNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

storeWhetherThisWindowMatchWindowExpression(currenWindowString,target,variableName)

肯定当前窗体是否包含该运行代码。

这对于代理注入代码模式很是有用，这些代码在每一个浏览器框架和窗体中运行，有时selenium server须要识别当前是哪一个窗体。这种状况下，当测试调用selectWindow，该程序将被每一个窗体调用以指出哪一个窗体被选择。被选择的窗体将返回true，而其余将返回false。

参数：

·currenFrameString – 开始窗体

·target – 新窗体(也许与当前窗体相关联，如，”_parent”)

·variableName - 用于存储结果的变量名。

Returns:

若是新窗体为该代码的窗体，返回true

同断言相关联，自动生成：

·assertWhetherThisWindowMatchWindowExpression (currenWindowString, target)

·assertNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

·verifyWhetherThisWindowMatchWindowExpression (currenWindowString, target)

·verifyNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

·waitForWhetherThisWindowMatchWindowExpression (currenWindowString, target)

·waitForNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

storeXpathCount(xpath,variableName)

返回匹配指定xpath的节点数，如”//table”将给出表的个数。

参数：

·xpath – 要计算的xpath表达式。不要用’count()’函数将该表达式包含起来，咱们将自动帮你做这件事。

·variableName - 用于存储结果的变量名。

Returns:

匹配指定xpath的节点数

同断言相关联，自动生成：

·assertXpathCount (xpath, pattern)

·assertNotXpathCount (xpath, pattern)

·verifyXpathCount (xpath, pattern)

·verifyNotXpathCount (xpath, pattern)

·waitForXpathCount (xpath, pattern)

·waitForNotXpathCount (xpath, pattern)

storeAlertPresent(variableName)

发生警告了?

该函数永远不会抛出异常

Returns:

若是有警告返回true

同断言相关联，自动生成：

·assertAlertPresent ()

·assertNotAlertPresent ()

·verifyAlertPresent ()

·verifyNotAlertPresent ()

·waitForAlertPresent ()

·waitForNotAlertPresent ()

storeChecked(locator,variableName)

获取一个关联性按钮(checkbox/radio)是否被勾选。若是指定元素不存在或不是一个关联性按钮，将失败。

参数：

·locator– 一个执行checkbox或radio按钮的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是该checkbox被勾选，返回true,不然返回false

同断言相关联，自动生成：

·assertChecked (locator)

·assertNotChecked (locator)

·verifyChecked (locator)

·verifyNotChecked (locator)

·waitForChecked (locator)

·waitForNotChecked (locator)

storeConfirmationPresent(variableName)

confirm()被调用了？

该函数永远不会抛出异常

Returns:

若是有一个未决的确认返回true

同断言相关联，自动生成：

·assertConfirmationPresent ()

·assertNotConfirmationPresent ()

·verifyConfirmationPresent ()

·verifyNotConfirmationPresent ()

·waitForConfirmationPresent ()

·waitForNotConfirmationPresent ()

storeEditable(locator,variableName)

断定指定的输入元素是否为可编辑，且ie没有被禁用。若是指定元素不为一个可输入元素，该函数将失败。

参数：

·locator – 一个元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是输入元素可编辑返回true，不然返回false

同断言相关联，自动生成：

·assertEditable (locator)

·assertNotEditable (locator)

·verifyEditable (locator)

·verifyNotEditable (locator)

·waitForEditable (locator)

·waitForNotEditable (locator)

storeElementPresent(locator,variableName)

验证指定元素在页面上。

参数：

·locator – 一个元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是该元素出现返回true，不然返回false

同断言相关联，自动生成：

·assertElementPresent (locator)

·assertNotElementPresent (locator)

·verifyElementPresent (locator)

·verifyNotElementPresent (locator)

·waitForElementPresent (locator)

·waitForNotElementPresent (locator)

storeOrdered(locator1,locator2,variableName)

检查这两个元素是否有相同的父级，且在DOM中为顺序亲属。两个相同元素将不考虑顺序。

参数：

·locator1 – 指向第一个元素的元素定位器

·locator2 – 指向第二个元素的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是元素1是元素2的兄长，返回true，不然返回false

同断言相关联，自动生成：

·assertOrdered (locator1,locator2)

·assertNotOrdered (locator1,locator2)

·verifyOrdered (locator1,locator2)

·verifyNotOrdered (locator1,locator2)

·waitForOrdered (locator1,locator2)

·waitForNotOrdered (locator1,locator2)

storePromptPresent(variableName)

发生提示了？

该函数永远不会抛出异常

Returns:

若是有一个未决的提示返回true

同断言相关联，自动生成：

·assertPromptPresent ()

·assertNotPromptPresent ()

·verifyPromptPresent ()

·verifyNotPromptPresent ()

·waitForPromptPresent ()

·waitForNotPromptPresent ()

storeSomethingSelected(selectLocator,variableName)

断定一个下拉菜单是否选择了某个选项。

参数：

·selectLocator – 一个用于识别下拉菜单的元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是选择某选项返回true，不然返回false

同断言相关联，自动生成：

·assertSomethingSelected (selectLocator)

·assertNotSomethingSelected (selectLocator)

·verifySomethingSelected (selectLocator)

·verifyNotSomethingSelected (selectLocator)

·waitForSomethingSelected (selectLocator)

·waitForNotSomethingSelected (selectLocator)

storeTextPresent(pattern,variableName)

验证指定文本出如今提交给用户的页面上。

参数：

·pattern – 用于匹配页面文本的范式

·variableName - 用于存储结果的变量名。

Returns:

若是该范式匹配文本返回true，不然返回false

同断言相关联，自动生成：

·assertTextPresent (pattern)

·assertNotTextPresent (pattern)

·verifyTextPresent (pattern)

·verifyNotTextPresent (pattern)

·waitForTextPresent (pattern)

·waitForNotTextPresent (pattern)

storeVisible(locator,variableName)

断定指定元素是否可见。一个元素能够经过将其自己或其父级的CSS”visibility”属性设定为”hidden”，或将”dispaly”属性设定为”none”，以使其不可见。若是该元素不存在，此方法将失败。

参数：

·locator – 一个元素定位器

·variableName - 用于存储结果的变量名。

Returns:

若是指定元素为可见返回true，不然返回false

同断言相关联，自动生成：

·assertVisible (locator)

·assertNotVisible (locator)

·verifyVisible (locator)

·verifyNotVisible (locator)

·waitForVisible (locator)

·waitForNotVisible (locator)

参数解释和变量