命令分类

1. 操作浏览器的：close，goBack ,createCookie ，deleteAllVisibleCookies ，deleteCookie ，goBack ，open ，openWindow ，selectWindow，deselectPopUp ，setBrowserLogLevel ,waitForFrameToLoad ，waitForPageToLoad ，waitForPopUp ,windowFocus ,windowMaximize ，storeAllWindowIds ，storeAllWindowNames ，storeAllWindowTitles ，storeCookie ，storeCookieByName ，storeCookiePresent ，storeTitle（单个页面），storeWhetherThisWindowMatchWindowExpression （浏览器窗口）

2. 操作键盘的：altKeyDown ,altKeyUp ,controlKeyDown ，controlKeyUp ，keyDown，keyPress ，keyUp ，metaKeyDown ，shiftKeyDown ，shiftKeyUp

3. 操作HTML 元素的

   • 通用：assignId，storeAttribute ，storeAttributeFromAllWindows ， storeBodyText ，storeElementHeight ，storeElementIndex ，storeElementPositionLeft ，storeElementPositionTop ，storeElementWidth ，storeHtmlSource ，storeText，storeValue ，storeXpathCount ，storeElementPresent ，storeOrdered ，storeTextPresent ，storeVisible
   • frame元素：storeWhetherThisFrameMatchFrameExpression
   • 下拉元素drop-down/select element：select，storeSelectedId ，storeSelectedIndex ，storeSelectedLabel ，storeSelectedValue，storeSomethingSelected
   • 多选元素multi-selection：addSelection,removeSelection ，storeSelectedIds，storeSelectedLabels，storeSelectedValues，storeSelectOptions
   • button：storeAllButtons
   • filed：storeAllFields
   • link：storeAllLinks
   • toggle-button (checkbox/radio)：check,uncheck ，storeChecked
   • 表格form：submit
   • table元素：storeTable
   • 右键会出现菜单的元素：contextMenu，contextMenuAt
   • link,button,checkbox,radio：click，clickAt ， doubleClick ， doubleClickAt
   • input,combo box,checkbox：type
   • input：storeEditable
   • 动态UI元素：typeKeys

4. 操作鼠标的（除去左键click）：dragAndDrop ， dragAndDropToObject ，mouseDown ,mouseDownRight ，mouseDownRightAt ，mouseMoveAt ，mouseOut ，mouseOver ，mouseUp，mouseUpAt ，mouseUpRight ，mouseUpRightAt，setCursorPosition ，setMouseSpeed ,storeCursorPosition

5. 操作 pop-ups的：answerOnNextPrompt , chooseCancelOnNextConfirmation ,chooseOkOnNextConfirmation，storeAlert ，storeConfirmation ，storePrompt ，storeAlertPresent ，storeConfirmationPresent ，storePromptPresent

6. 操作通知消息的：assertErrorOnNext ，assertFailureOnNext ，

7. 直接操作JS代码的 addScript,removeScript,runScript,storeEval，store ，waitForCondition ，storeExpression

8. 浏览器兼容相关：allowNativeXpath ，storeAttribute ，storeCursorPosition

9. 自定义：addLocationStrategy

10. 其他
    break ,captureEntirePageScreenshot ,echo ，fireEvent ，focus ，highlight ,ignoreAttributesWithoutValue ，setSpeed ，useXpathLibrary ，storeSpeed

selenium Actions

重点关注可以做什么，怎么做

addLocationStrategy ( strategyName,functionDefinition )
自定义页面定位元素的函数。
使用示例：
addLocationStrategy ( foo,functionDefinition )
click(“foo=blah”)
foo是定义的策略，blah的作为string参数被传入，blah应该是定位的关键字。这时候一共会传入三个参数：

• locator:定位关键字，用户传入的string参数。示例中blah。
• inWindow:当前选择的窗口
• inDocument：当前选择的DOM对象

参数：

• strategyName：定位策略的名称，only letters [a-zA-Z]
• functionDefinition：JS代码

addScript ( scriptContent,scriptTagId )
在selenium文件里加载一段scriptContent到一个新的脚本tag中，应该是用脚本TagId来指代一段代码。相似但区别于runScript：不是将Tag加在Selenium文档而是AUT文档。在scriptContent里实体用
<scriptTagId> 指代。
参数：

• scriptContent：被加入的JS内容
• scriptTagId: 可选项，新的脚本tag，如果指定了且元素的id已经存在了，操作失败。

removeScript ( scriptTagId )

runScript ( script )
在当前的测试窗口建立一个新的脚本Tag，并在命令中加入特定的文本。这种方式比getEval命令要好调试。这种JS代码甩出的异常selenium不会处理，需要自己在脚本加上try/catch。
getEval命令可能已弃用了，现存命令storeEval，在Assertion一节。

addSelection ( locator,optionLocator )
在多选元素（multi-select element）中，新增一个已选项。参考doSelect查看选项定位的细节。
这个doSelect是什么：
1. JS Select事件？好像不是很符合，原文“触发、或将函数绑定到指定元素的 select 事件;当 textarea 或文本类型的 input 元素中的文本被选择时，会发生 select 事件”，是用来定义此事件发生后，如何处理时使用。
2. HMTL对象select标签?，不是很符合。HMTL说他是下拉列表选项。找到一个HTML DOM options 集合, HTML dom 对象select的对象集合？
3. 是select() selenium IDE的函数，为什么要前缀do？见“添加Actions”一节。

参数：

• locator：识别出多选框的元素定位器。之后的这个参数都没写。
• optionLocator: 选项定位器，默认是通过label定位。lable含义键select 命令解释。

removeSelection ( locator,optionLocator )

select ( selectLocator,optionLocator )
使用选项定位器从一个下拉选项元素中选择一个选项。

选项定位器：

• label=labelPattern:默认， lable的定义，没说得完全清楚，举了一个例子: visibel text
• label=regexp:^[Oo]ther

• value=valuePattern：也不太清楚value的定义，可能是value属性吧

• id=id: 选项的id

• index=index：从0开始计数：

  • index=0，第一个选项

参数：

• selectLocator：元素定位器，元素必须是下拉菜单元素
• optionLocator：略

下拉drop-down元素有：
<select>

allowNativeXpath ( allow )
allow为真，如果浏览器存在的话，允许使用浏览器内置原生实现版本XPath。为假，对应的是pure-JavaScript xpath library。后者兼容性好一些，但是要慢一些。

参数：

• allow: 布尔量

assignId ( locator,identifier )
暂时赋予元素id,在后来的测试中，就可以通过id来而不是用慢的/复杂的xpath来定位。page一旦重新下载，那么id就会失效。

altKeyDown ( )
按下alt键，直到doAltUp()被调用或者是新的页面下载完毕。

altKeyUp ( )
释放alt键

controlKeyDown ( )
按住control键，直到doControlUp()被调用或者新页面下载完毕

controlKeyUp ( )

break ( )
暂停现在的测试，直到用户按下continue按钮（debug处）,debug的时候用

captureEntirePageScreenshot ( filename,kwargs )
保存内容：current window canvas
保存文件格式: PNG
只能在以下两种情况使用：

• FF/FireFox在Chrome模式运行时，FF实现版借用Screengrab，它是FF的扩展。
• in IE non-HTA using the EXPERIMENTAL Snapsie utility.

相似命令有captureScreenshot（保存内容为 OS viewport,仅在RC模式实现，IDE没有此命令）

参数：

• filename：存储的文件路径。默认无后缀。如果路径不存在，会抛出异常
• kwargs：修改截图信息，现有有效的信息：
• “background=#CCFFDD”：修改HTML文档中CSS的背景。原因：在非理想状态下的布局截图可能会出现异常，如绝对定位会使Canvas维度计算失败，截图会呈现黑色背景，可能会看不到黑色的字。

check ( locator )
勾选元素
针对元素：checkbox、radio

uncheck ( locator )
对应check命令，取消勾选元素：checkbox or radio

answerOnNextPrompt ( answer )
下一次JS prompt出现时，指示selenium返回特定的答案。
JSprompt长这样：window.prompt()

参数：

• answer：要返回的消息

chooseCancelOnNextConfirmation ( )
下一次确定框出现时，选择“取消”键。
针对对象：window.confirm()
默认情况下，selenium遇到window.confirm()函数会返回ture，相当于人手动点击OK。如果要选择“取消”键，就要用此命令显示地写出来，如果有很多条，那每条都要显示地写出来。
每一次一个确认框起来了，你必须用getConfirmation去处理它，不然下一步操作会失败。在selenium IDE中，采用这个命令就相当于用getConfirmation去处理了。

chooseOkOnNextConfirmation ( )
取消chooseCancelOnNextConfirmation的效果。
其实不必特意写这条命令，除非在特殊情况下你想提前指示好确认框的选项。

click(locator)
点击某元素。
适用对象：link,button,checkbox,radio。所以说check没什么卵用。如果操作导致了新页面下载，要用waitForPageToLoad处理。

clickAt ( locator,coordString )
点击元素旁边的某个元素（link,button,checkbox,radio）。有些元素不好用locator定位，就定位它旁边的元素，再通过相对位置去定位。

参数：

• coordString:相对于locator的相对位置，如(-10,20)。虽然没有说明，应该是向左向下为正？

doubleClick ( locator )
双击元素
支持对象：link, button, checkbox or radio。如果操作导致了新页面下载：waitForPageToLoad

doubleClickAt ( locator,coordString )
双击对象

close()
点击关闭按钮
适用对象：titlebar of a popup window or tab

goBack ( )
点击浏览器back按钮

contextMenu(locator)
模拟打开context menu。有些元素用户“右键点击”时会出现菜单。这个命令就模拟打开这个菜单。

contextMenuAt ( locator,coordString )
操作元素旁边的某个地方。有些元素不好用locator定位，就定位它旁边的元素，再通过相对位置去定位。

createCookie ( nameValuePair,optionsString )
创建一个cookie。path和domain两个参数值必须和现在的正在测试页面一样，除非你显示地指定了path的值。

参数：

• nameValuePair：格式 “name=value”
• optionsString：options for the cookie。
  现在支持：’path’, ‘max_age’ and ‘domain’。
  格式是：”path=/path/, max_age=60, domain=.foo.com”。与顺序无关，max_age的单位是秒。如果domain不是当前domain的子集的话，创建会失败。

deleteAllVisibleCookies ( )
删除当前页面所有的可见的cookie，内在逻辑是参数设置“recurse=true”时调用deleteCookie函数。这个方式比“known domain/path”的deleteCookie 方式慢。

deleteCookie ( name,optionsString )
通过指定domain/path来删除cookie。需要使用确切的、用来创建cookie时使用的path和domain。不然就会失败，还有如果domain不是当前domain的子集的话，操作会失败。实际上，不可能获取到特定cookie当前实时的源path和dormain，所以就加了recurse的方法，就是deleteAllVisibleCookies ，想当慢，O(n*m)的时间消耗，n是domain name的总个数，m是path里面反斜杠的个数。

参数：

• name：cookie的名字， “name=value”中的name
• optionsString：options for the cookie。
  现在支持：’path’, ‘domain’ and ‘recurse。
  格式是：”path=/path/, domain=.foo.com, recurse=true”。与顺序无关，max_age的单位是秒。如果domain不是当前domain的子集的话，创建会失败。

dragAndDrop ( locator,movementsString )
拖拽一定的距离

参数：

• locator：元素定位器
• movementsString：相对于当前元素的偏移位置：“+70,-300”

dragAndDropToObject ( locatorOfObjectToBeDragged,locatorOfDragDestinationObject )
拖拽一个元素，把他放到另一个元素之上。通常是放在目标元素的中心。

参数：
-locatorOfObjectToBeDragged：元素定位器
-locatorOfDragDestinationObject ：元素定位器

echo ( message )
在log面板上打印信息。debug时很有用。

参数：

• message ：要打印的信息。字符串和${变量名}都可以。

fireEvent ( locator,eventName )
在元素上发起事件。事件名称是onXXX的XXX。具体元素有哪些事件可fire，需要查看对应的标签文档，或者是查看浏览器的debug信息栏的内容。

参数:

• eventName：the event name, e.g. “focus” or “blur”

focus ( locator )
将焦点移到特定元素上。如果这个元素是input element，那么就是把输入光标移过去。

highlight ( locator )
高亮某个元素，debug用

ignoreAttributesWithoutValue ( ignore )
清楚地说明selenium是否应该忽略掉无值的xpath属性，比如空字符串（ when using the non-native xpath evaluation engine）。
在IE浏览器中考虑到性能时，你可能需要采取此措施。这个命令会破坏掉一些特定的xpath，比如其他定位到属性（属性值不为空字符串）的XPath，不太清楚为啥会影响到。唯一希望的是，这种xpath相对来说比较少，但是用户至少应该有权选择是否使用这些xpath。注意，这个只影响那些使用ajaxslt engine（非javascript-xpath）的xpath。

参数：

• ignore ，布尔值，为真，意味着问会以正确性为代价来忽略无值属性。为假，意味着为正确性来牺牲速度。

keyDown ( locator,keySequence )
模拟用户按压一个键，不释放

参数：

• keySequence： 输入的键盘序列，用”\”标记，后面是键盘的数字“键盘码” ，通常是此键盘值的ASCII值。如果是单个字母，直接输入即可: “w”, “\119”。

keyPress ( locator,keySequence )
模拟用户按压一个键，要释放

keyUp ( locator,keySequence )
模拟用户释放一个键，与keyDown组合起来使用

metaKeyDown ( )
按下meta键，直到dometaUp()被调用或者新页面下载完毕

metaKeyUp ( )
模拟用户释放meta键

shiftKeyDown ( )
模拟按下shift键，等到调用函数doShiftUp()或者新的页面被加载

shiftKeyUp ( )

mouseDown ( locator )
鼠标左键，不释放
至今为止没有get到正确用法

mouseDownAt ( locator,coordString )
按下鼠标左键，不释放，相对于某一元素的位置

mouseDownRight ( locator )
按下鼠标右键，不释放

mouseDownRightAt ( locator,coordString )
按下鼠标右键，不释放，相对于某一元素的位置

mouseMoveAt ( locator,coordString )
模拟按下鼠标拖动 ，不释放，从元素的位置拖动到指定的相对位置

mouseOut ( locator )
将鼠标从某个元素移开

mouseOver ( locator )
移到某个元素上面

mouseUp ( locator )
用户释放鼠标键

mouseUpAt ( locator,coordString )

mouseUpRight ( locator )
释放鼠标右键

mouseUpRightAt ( locator,coordString )

open ( url )
模拟在测试frame中打开指定URL。此URL可以是绝对或者相对URLs。open命令会打开网页并等待其下载完毕，有一个隐形的“AndWait”后缀。由于浏览器的安全政策（相同的源策略），URL打开需要是在同一个domain下。如果需要打开另外一个，那么需要使用selenium sever打开一个新的浏览器session。

参数：

• url ：需要打开的URL，可以是相对的，也可以是绝对的。

openWindow ( url,windowID )
打开一个popup 浏览器窗口，如果此ID的窗口还没有被打开。打开了之后，如果要在此窗口中操作，需要使用selectWindow命令。

用此命令去走查 bug SEL-339。在有些时候，selenium会截取不到window.open的调用，比如此时的调用发生在onload事件之间或者之前。这个时候的解决方法就是强制打开一个窗口：openWindow(“”, “myFunnyWindow”)，此时url为blank，后面的是窗口的名字。

参数：

• windowID ： 要选择的JS 窗口ID。这个意义是，这个窗口ID在JS层面上是有意义的。

selectWindow(windowID)
选择一个弹出窗口。一旦被选择，以后命令在此窗口中执行，如果要选择主窗口，windowID=null即可。

几种形式的Window Locators

• title=My Special Window：title对应在网页的title bar出现的文字text。应当要注意，有可能会有两个窗口共享一个名称。如果发生了，定位器只会定位其中的一个。
• name=myWindow：对应JavaScript method window.open(url, windowName, windowFeatures, replaceFlag)的第二个参数，通过内部JS “name”属性去定位window
• var=variableName：一些弹出的匿名/无名窗口，可能在当前与JS变量名相对应。比如说之前使用过：“window.foo = window.open(url)”，这种时候可以使用变量名定位窗口的方法，变量名为foo。

如果无法准确知道Window Locator，下面有几项原则可以利用：
1. 源窗口：windowID 就是null/string null
2. JS window.open()的返回值：windowID 是 JS 变量名
3. 其他情况，selenium会去查询一个hash表，这个表保存字符串和window name的映射（map）关系
4. 如果失败了，会遍历所有的已知窗口来找到一个合适的“title”，由于title不是唯一的，很有可能会出现未知错误

name=myWindow：
[图片上传失败...(image-508b86-1539420106645)]

X就是window的ID，在执行openWindow命令时赋给窗口的。
如果你对如何查看window的名称有疑问的话，可以查看selenium的日志消息，里面有通过window.open()创建的windows的名称。以下为日志消息示例：
debug: window.open call intercepted; window ID (which you can use with selectWindow()) is “myNewWindow”

实际我以 openWindow|web|空|的方式去打开的提示
[图片上传失败...(image-30a75b-1539420106645)]

把log级别调到debug级别：出现了
[图片上传失败...(image-e5bb7b-1539420106645)]

在某些情况下，selenium可能截取不到window.open的名称，比如说事件调用发生在“onLoad”时间之前或者之间（前面提到的bug SEL-339）。在这些情况下，你需要通过openWindow命令来强制性地通知selenium的名称，此时url应设置为空：openWindow(“”, “myFunnyWindow”)

deselectPopUp ( )
选择主窗口。等效于 selectWindow() windowID=null。

setBrowserLogLevel ( logLevel )
设置浏览器的日志级别
设置日志级别：”debug”, “info”, “warn”, “error” or “off”。
如何查看日志：GUI模式在日志窗口查看，或者在RC模式enable browser-side logging(应该是浏览器侧查看)

参数：

• logLevel：”debug”, “info”, “warn”, “error” or “off”

setCursorPosition ( locator,position )
设定text cursor到特定位置
位置指向：input element or textarea，如果不是这两种元素，命令可能会失败

参数：

• locator：位置指向，input element or textarea
• position：in the field(应该是input or textarea的整个可操作空间)的数值型位置。为0，在field的开始位置；-1，在field结束的位置。应该是从左到右算开始和结束

setMouseSpeed ( pixels )
设置在dragAndDrop命令中”mousemove” events的鼠标的移动速度（按pixel计算，默认为10）。也就是在此命令中mousemove事件的间隔pixel：移动多少pixel，发起一次这个”mousemove” 事件。
pixel为0时，在开始位置和结束位置中间每移动一个pixel都会发起一次”mousemove” events，这样肯定就会很慢，有可能会导致一些浏览器强制性使JS代码超时。
如果此速度大于了起始点的距离（怪怪的，先这么理解吧），那么在起始位置之间（拖拽命令时）就只发起一次事件。

setSpeed ( value )
设定selenium操作的执行速度，比如在命令之间插入固定XXms。默认，无此时间，为0ms。

参数：

• value：操作之间的固定暂停时间，以毫秒ms计

setTimeout ( timeout )
告诉Selenium等待actions的超时时间，默认为30s。
这些action有：open、waitForXXX

参数：

• timeout：超时时间，以毫秒ms计。此时间之后，action会返回错误。

store ( expression,variableName )
与storeExpression同义（synonym）

参数：

• expression：要存储的value。可以把计算式当做要赋的值，jS计算式或者JS代码段。
• variableName：变量名

submit ( formLocator )
操作UI类的
提交特定的form，比如：只有单个输入的 “Search” forms，这种没有submit按钮的表格，这种表格一般会把提交绑定到enter键上面。

参数：

• formLocator ：表格元素的定位器

type ( locator,value )
操作UI类的
如果是input field：模拟给输入框打字；如果是comboboxes, checkboxes，值应该是option的值，而不是可见的text(参见option selected)

参数：

• value：官方文档写的需要写入的内容。不知道作option时应该怎么做。

typeKeys ( locator,value )
模拟在特定元素上键盘敲击事件，一个键一个键地输入。
相比于type ( locator,value )此命令会在敲击的字母之间调用keyDown, keyUp, keyPress这些事件。举个例子：测试对象是动态UI widget时，比如auto-completing combo boxes，这种需要显示地（explicit）键盘事件，使用typeKeys 就会方便很多。
不像是type命令，会强制性将值填入页面，这些命令可能会/不会有明显的效果。有些时候typeKeys 命令也不会有明显效果：比如在一个form元素上使用，你就看不到type效果。

在某些情况，你可能需要type按钮设置field的值，然后再用本命令来发送键盘敲击事件。

useXpathLibrary ( libraryName )
允许使用xpath库

参数：

• libraryName ：有以下选项
• “ajaxslt”：Google’s 库
• “javascript-xpath”：Cybozu Labs’ faster library
• “default” - 默认库：现目前为止是 “ajaxslt” .
• 如果没有使用以上三种，那么就不生效，使用默认的

waitForCondition ( script,timeout )
script: JavaScript snippet，[中]JS代码片段。
此命令是重复的运行指定的JS代码片段直到代码返回true或者时间超时。命令可以有多行，只有最后一行的结果（true or false）才会被考虑。
要注意的是，代码是在runner’s test的窗口中执行，而不是被测应用的窗口。为了获取你应用的window，需要使用以下代码片段：

selenium.browserbot.getCurrentWindow()

这样就可以在应用窗口中执行了

waitForFrameToLoad ( frameAddress,timeout )
等待一个新frame被加载
Selenium会不间断地保持新页面和frame的加载，并在页面加载完成后设置“newPageLoaded”的状态字。
参考waitForPageToLoad获取更多信息。

参数：

• frameAddress：在服务器端的frame地址

waitForPageToLoad ( timeout )
等待一个新页面加载完毕。
可以使用这个命令替代“XXXAndWait”命令。
Selenium会不间断地保持新页面和frame的加载，并在页面加载完成后设置“newPageLoaded”的状态字。。之后执行其他selenium命令后会将这个状态字翻转。所以你想使用此命令，应该将此命令紧跟着放在“会引起页面加载的命令”之后。

waitForPopUp ( windowID,timeout )
等待一个窗口弹起显示并加载完成。

• windowID：如果没有指定窗口的名称（或者指定为了null）的话，那么日志中就会出现JS window “name” 。但是如果你是在操作多个窗口的话，还是要指定好窗口名称。这个命令会一直等待等到第一个非顶层（non-top）窗口显示。
• timeout：如果没有设置这个值，用默认的超时时间，参考setTimeout()命令，当前写的是30s。

windowFocus ( )
聚焦在当前选择的窗口

windowMaximize ( )
最大化窗口。窗口是当前选择的窗口，最大化是最大化到铺满当前屏幕。毕竟屏幕要自适应。

rollup( rollupName,kwargs )
执行此命令，可以将一系列的命令组合起来使用单个名字，可以用kwargs来决定选取其中的哪些命令。如果其中一个命令失败了，此命令失败。

参数

• rollupname：命令组合使用的名称
• kwargs：影响选取命令的参数

参看UI-element查看如何内在逻辑

Selenium Accessors

[中]访问器，读取器。检查应用的状态，存储变量结果，如“storeTitle”。也用来自动生成Assertions

每个Accessors都有对应的6个Assertions：

• assertXXX、assertNotXXX
• verifyXXX、verifyNotXXX
• waitForXXX、waitForNotXXX

assertErrorOnNext ( message )
告诉Selenium在下一次命令执行时应该有一个错误生成。

参数：

• message ：应该生成的错误消息。如果不是这个错误信息，那么此命令会fail。

相关命令：

• assertNotErrorOnNext ( message )
• verifyErrorOnNext ( message )
• verifyNotErrorOnNext ( message )
• waitForErrorOnNext ( message )
• waitForNotErrorOnNext ( message )

assertFailureOnNext ( message )

相关命令：

• assertNotFailureOnNext ( message )
• verifyFailureOnNext ( message )
• verifyNotFailureOnNext ( message )
• waitForFailureOnNext ( message )
• waitForNotFailureOnNext ( message )

assertSelected ( selectLocator,optionLocator )
弃用

storeAlert ( variableName )
将上个命令产生的JS Alert(HTML原生的)消息保存下来，如果没有alerts就此命令执行会失败。
获取alert和手动点击OK键有相同效果（点击不OK/取消是要设置的），如果alert生成，但是你没有用getAlert去获取，那么下一次action就会失败。
在Selenium的运行下，JS不会显示地弹出窗口，但是可以通过代码操作。
Selenium不支持在onload()事件的处理器中（handler）产生的JS alerts。在这种情况下，一个显示地窗口会产生，Selenium会暂停测试直到人为的点击了OK。

返回量：

• 最新JS alerts的消息

storeConfirmation ( variableName )
confirmation：[中]确定。
将上个命令产生JS确定窗口的消息保存下来。默认情况下，这个confirm funtion会产生true,和手动点击OK一个效果。可以通过chooseCancelOnNextConfirmation改变。
如果产生了确定弹框，如果没有通过getConfirmation去获取，那么下一次action就会失败。
在Selenium的运行下，JS不会显示地弹出窗口，但是可以通过代码操作。
Selenium不支持在onload()事件的处理器中（handler）产生的JS 弹出窗口。在这种情况下，一个显示地窗口会产生，Selenium会暂停直到人为的点击了OK。

返回量：

• 最新JS 确定框的消息

storePrompt ( variableName )
question prompt：[中]问题提示
成功处理prompt需要前面answerOnNextPrompt命令的执行，如果prompt产生了，你没有去get/verify，那么下一次selenium操作就会失败。
在Selenium的运行下，JS不会显示地弹出窗口，但是可以通过代码操作。
Selenium不支持在onload()事件的处理器中（handler）产生的JS 弹出窗口。在这种情况下，一个显示地窗口会产生，Selenium会暂停直到人为的点击了OK。

返回量：

• 最新JS 问题提示的消息

storeAllButtons ( variableName )
返回页面上所有button的ID
如果某个button没有ID,那么在数组中的值为“”

返回量：

• 页面上所有button的ID

storeAllFields ( variableName )
返回页面上所有field的ID
如果某个Field没有ID,那么在数组中的值为“”

返回量：

• 页面上所有Field的ID

storeAllLinks ( variableName )
返回页面上所有Link的ID
如果某个Link没有ID,那么在数组中的值为“”

返回量：

• 页面上所有Link的ID

storeAllWindowIds ( variableName )
返回页面上所有Window的ID
如果某个Window没有ID,那么在数组中的值为“”

返回量：

• 页面上所有浏览器知晓的Window的ID

storeAllWindowNames ( variableName )

storeAllWindowTitles ( variableName )

storeAttribute ( attributeLocator, variableName )
获取一个元素属性的值，这个属性值可能会随浏览器不一样，比如说style的属性。浏览器兼容性

storeAttributeFromAllWindows ( attributeName, variableName )
从所有已知窗口获取JS属性值

storeBodyText ( variableName )
存储页面上所有的文字

storeCookie ( variableName )
将在测试的当前页面所有的cookie保存下来

storeCookieByName ( name, variableName )

storeCursorPosition ( locator, variableName )
获取在指定input元素和textarea的text cursor。注意：不是所有浏览器都支持这个命令。浏览器兼容性
特别地，如果cursor/selection已经被JS清除了，那么这个命令将会返回cursor上一次的位置（尽管cursor已经不在当前页面了），bug编号SEL-243。

参数：

• locator：input元素和textarea

返回量：

• cursor在field的numerical 位置

storeElementHeight ( locator, variableName )
获取一个元素的高，以pixel计。

storeElementIndex ( locator, variableName )
获取一个元素的index，这个index是相对于他的父元素、且从0开始计数。comment node和empty text node会被忽略掉

storeElementPositionLeft ( locator, variableName )
获取一个元素的水平位置，以pixel计，已背景frame做参考。

参数：

• locator：an element locator pointing to an element OR an element itself

返回量：

• of pixels from the edge of the frame.

storeElementPositionTop ( locator, variableName )
获取一个元素的垂直位置，以pixel计，已背景frame做参考。

storeElementWidth ( locator, variableName )

storeEval ( script, variableName )
存储JS代码片段执行后的结果，只保存最后一行的结果
注意： 片段只会selenium object里执行，所以this指针指的selenium 对象。需要用window来指向应用：

window.document.getElementById('foo')

如果需要用定位器指向单独的元素，你可以这样：

this.browserbot.findElement("id=foo")

“id=foo”就是你的元素定位器。

storeExpression ( expression, variableName )
返回指定的expression
在JS处理过程中特别有用。用来生成assertExpression和waitForExpression

参数：

• expression：要返回的值

返回值：

• 传入的值

就是将expression（JS）等同于变量名(Selenese)的操作。

storeHtmlSource ( variableName )
返回整个HTML源代码：在html开始标签和结束标签之间的所有代码

storeLocation ( variableName )
获取当前页面的绝对URL

storeMouseSpeed ( variableName )
获取当前的MouseSpeed，拖拽（DragAndDrop）操作的速度

storeSelectedId ( selectLocator, variableName )
在特定的select元素中，获取选中选项的ID

参数

• selectLocator：a drop-down menu定位器

storeSelectedIds ( selectLocator, variableName )
在特定的select元素中，获取选中选项的IDs。
a drop-down menu，but a multi-select element

返回值：

• 存储选中选项的数组

storeSelectedIndex ( selectLocator, variableName )
index：选项的索引值，从0开始计数
select 元素：a drop-down menu

storeSelectedLabel ( selectLocator, variableName )
label: 对用户可见的text
select 元素：a drop-down menu

storeSelectedLabels ( selectLocator, variableName )
a drop-down menu，but a multi-select element

storeSelectedValue ( selectLocator, variableName )
获取已选项的值：value attribute
select 元素：a drop-down menu

storeSelectedValues ( selectLocator, variableName )

storeSelectOptions ( selectLocator, variableName )
将drop-down所有选项都返回

storeSpeed ( variableName )
selenium命令的执行延时时间，执行速度，以毫秒ms计。

storeTable ( tableCellAddress, variableName )
获取table中一个cell的text。
CellAddress语法：tableLocator.row.column,行列号都从0开始

参数：

• tableCellAddress：CellAddress，比如，foo.1.4

返回量：

• 特定cell中的文字

storeText ( locator, variableName )
获取元素的text。
适用元素：任何包含text的元素都可以。
text-content属性值的内容（Mozilla-like），或者是innerText的内容（IE-like），都是呈现给用户的text的部分。

storeTitle ( variableName )
获取当前页面的title

storeValue ( locator, variableName )
获取input field（或者其他有value parameter的元素）的value，这个value值会将空格符号删减掉。比如“a B”，获取下来就是“aB”。对于checkbox/radio元素，这个值应该是“on”或者“off”，分别对应这个元素是否被checked。

storeWhetherThisFrameMatchFrameExpression ( currentFrameString, target, variableName )
查看这个current/locator的frame是否包含了运行代码。（Determine whether current/locator identify the frame containing this running code）

在proxy injection mode很有用，这种模式下code会在每个浏览器的frame和窗口中运行，有时候selenium服务器需要识别当前“current” frame。在这种情况下，test会callselectFrame，这时候每个Frame都会来确定它是否是当前被选择的selected frame，如果是返回true,反之亦然。

参数：

• currentFrameString：开始frame
• target：新frame，相对于当前的frame
• variableName：存储结果的变量

返回量：

• 布尔量，这个新frame是否是this code’s window

storeWhetherThisWindowMatchWindowExpression ( currentWindowString, target, variableName )
查看当前的currentWindowString plus target识别出window containing this running code。
同样是proxy injection mode情况下使用，当test calls selectWindow，selenium server会调用每个窗口去查看是否是 current window/被选中的window。返回布尔量

参数：

• currentWindowString：starting window
• target：new window (which might be relative to the current one, e.g., “_parent”)
• variableName：存储结果的变量

返回量：

• 布尔量，true if the new window is this code’s window

storeXpathCount ( xpath, variableName )
满足特定范式的xpath的节点（node）数量。这里的node是DOM或者CSS的概念。特定范式示例：“//table”， 则此命令会存储table的数量。

参数：

• xpath：xpath表达式。不要把这个表达式放在count()函数里，selenium会为你做这一步。

返回量：
-满足特定范式的xpath的节点数量

count()是此命令背后selenium调用的JS函数
[图片上传失败...(image-88cdc9-1539420106640)]

storeAlertPresent ( variableName )
布尔量，存储是否有告警出现

storeConfirmationPresent ( variableName )
布尔量，存储是否有确认框出现

storePromptPresent ( variableName )

storeElementPresent ( locator, variableName )
布尔量，存储是否某个元素出现

storeChecked ( locator, variableName )
布尔量，whether a toggle-button (checkbox/radio) is checked。如果定位器元素不存在，或者不是toggle-button，此命令会失败

storeCookiePresent ( name, variableName )
是否有满足名称的cookie出现

storeEditable ( locator, variableName )
元素：input element
是否可以编辑，或者是被禁用

storeOrdered ( locator1, locator2, variableName )
查看两个元素是否在DOM中有相同的父节点且是有顺序的兄弟节点。相同的节点不会被认为是有顺序的。

参数：

• locator1：元素1
• locator2：元素2

返回值：

• 正确顺序是元素1在前，元素2在后

storeSomethingSelected
元素：drop-down menu
只要里面有选项被选择，返回真。应该不分多选和单选元素

storeTextPresent ( pattern, variableName )
在rendered（[中]提供）的页面上是否有满足范式的text

参数：

• pattern：文本应满足的范式

storeVisible ( locator, variableName )
存储一个元素是否可见。元素可以被设置成不见：CSS 中”visibility” 属性值为 “hidden”的时候，或者”display” 属性值为 “none”。如果元素不出现的时候执行此命令会失败。注意，present和visible是两个概念。

Parameter construction and Variables

selenium命令参数variableName有两种方式：简单的变量代替，全部的JS表达式（JS expression）。这两种机制都可以获得之前存储好的变量，只是使用不同的语法。这两种方式不能混用（variable substitution cannot be combined with javascript evaluation）。

Stored Variables

命令：应该是指所有的store系列命令，它这里写的是store、storeValue、storeText可以存储一些变量备用。在内部实现中，这些变量都存储在一个map中，这个map名叫“storedVars”，变量名和值一一对应，以变量名为键。可以把它想成一个简单的表：

Variable substitution

变量替代法将表达式用变量的形式存储起来，使用${variableName}就可以引用。多个变量也可以这种方式，还可以和静态文本混合起来使用：

JS evaluation

这种方式就是使用JS代码来创建命令参数。使用这种机制，整个参数值必需用javascript{...}的形式。括号中间的就是JS expression。然后可以通过store命令将JS表达式存储起来。

这种形式，可以利用JS的函数来使赋值变得灵活。

空格规则

HTML会自动规范元素之间的空格：

• 忽略掉 leading/trailing 空格；
• 将多余的空格，tabs，newlines变成一个空格。

当selenium从一个页面读取文本的时候，也会重复这一行为，所以在做assertion的时候就要考虑到这一点，直接按页面展示来进行测试。
selenium将所有不可见的空格（non-visible whitespace, including the non-breaking space “ ”）都转为一个空格，所有可见的新行标签（<br> <p> <pre>）会保留。
在selenese本身的HTML版本中也采取同样是空格规则。selenese中新行标签是<td>标签。
如果要加空格的话，可以使用selenese的${space}或者${nbsp}，这样的空格不遵守空格规则，也可以叠加。
XPath不遵守这种空格简化的规则（XPaths do not normalize whitespace the way we do）。

你根据网页直观看到的样子写出来的XPath：//div[text()="hello world"]
网页的HTML版本："hello world"
selenese HTML存储的样子：//div[text()="hello world"]
你应该这样写：//div[text()="hello${nbsp}world"]
最后HMTL存储的样子：//div[text()="hello${nbsp}world"]
这样才能正确链接到text()=hello world的元素