Selenium Commands

一、 Commands (命令)

Action 对当前状态进行操作 失败时，停止测试 Assertion 校验是否有产生正确的值Element Locators 指定HTML中的某元素Patterns 用于模式匹配

1. Element Locators (元素定位器)

id=id id locator 指定HTML中的唯一id的元素 name=name name locator指定 HTML中相同name的元素中的第一个元素 identifier=id identifier locator 首先查找HTML是否存在该id的元素, 若不存在，查找第一个该name的元素 dom=javascrīptExpression dom locator用Javascrīpt表达式来定位HTML中的元素,注意必须要以"document"开头 例如: dom=document.forms['myForm'].myDropdown dom=document.images[56] xpath=xpathExpression xpath locator用 XPath 表达式来定位HTML中的元素,必须注意要以"//"开头 例如： xpath=//img[@alt='The image alt text'] xpath=//table[@id='table1']//tr[4]/td[2] link=textPattern link locator 用link来选择HTML中的连接或锚元素 例如: link=The link text在没有locator前序的情况下 Without a locator prefix, Selenium uses: 如果以"document."开头，则默认是使用 dom locator，如果是以"//"开头，则默认使用xpath locator,其余情况均认作identifier locator

2. String Matching Patterns (字符串匹配模式)

glob:patthern glob模式，用通配符"*"代表任意长度字符，"?"代表一个字符regexp:regexp 正则表达式模式，用Javascrīpt正则表达式的形式匹配字符串exact:string 精确匹配模式，精确匹配整个字符串，不能用通配符在没有指定字符串匹配前序的时候，selenium 默认使用glob 匹配模式

3. Select Option Specifiers (Select选项指定器)

label=labelPattern 通过匹配选项中的文本指定选项 例如：label=regexp:^[Oo]thervalue=valuePattern 通过匹配选项中的值指定选项 例如：value=otherid=id 通过匹配选项的id指定选项 例如: id=option1index=index 通过匹配选项的序号指定选项，序号从0开始 例如：index=2在没有选项选择前序的情况下，默认是匹配选项的文本

二、 Actions 描述了用户所会作出的操作。 Action 有两种形式: action和actionAndWait, action会立即执行，而actionAndWait会假设需要较长时间才能得到该action的相响，而作出等待，open则是会自动处理等待时间。

click click(elementLocator) - 点击连接,按钮，复选和单选框 - 如果点击后需要等待响应，则用"clickAndWait" - 如果是需要经过Javascrīpt的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。 clickaCheckbox clickAndWaitsubmitButton clickAndWaitanyLink open open(url) - 在浏览器中打开URL,可以接受相对和绝对路径两种形式 - 注意：该URL必须在与浏览器相同的安全限定范围之内 open/mypage openhttp://localhost/ type type(inputLocator, value) - 模拟人手的输入过程，往指定的input中输入值 - 也适合给复选和单选框赋值 - 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本 typenameFieldJohn SmithtypeAndWaittextBoxThatSubmitsOnChangenewValue select select(dropDownLocator, optionSpecifier) - 根据optionSpecifier选项选择器来选择一个下拉菜单选项 - 如果有多于一个选择器的时候，如在用通配符模式，如"f*b*",或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值 select dropDownAustralian Dollarsselect dropDownindex=0selectAndWaitcurrencySelectorvalue=AUDselectAndWaitcurrencySelectorlabel=Auslian D*rs goBack,close goBack() 模拟点击浏览器的后退按钮 close() 模拟点击浏览器关闭按钮selectWindow select(windowId) - 选择一个弹出窗口 - 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行 selectWindowmyPopupWindow selectWindownull pause pause(millisenconds) - 根据指定时间暂停Selenium脚本执行 - 常用在调试脚本或等待服务器段响应时 pause5000 pause2000 fireEvent fireEvent(elementLocatore,evenName) 模拟页面元素事件被激活的处理动作 fireEventtextFieldfocusfireEventdropDownblur waitForCondition waitForCondition(JavascrīptSnippet,time) - 在限定时间内，等待一段Javascrīpt代码返回true值，超时则停止等待 waitForConditionvar value="/selenium.getText(""foo"); value.match(/bar/);3000 waitForValue waitForValue(inputLocator, value) - 等待某input(如hidden input)被赋予某值， - 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞 waitForValuefinishIndicationisfinished store,stroreValue store(valueToStore, variablename) 保存一个值到变量里。 该值可以由自其他 变量组合而成或通过Javascrīpt表达式赋值给变量 storeMr John Smithfullnamestore$.｛title｝ $.｛firstname｝ $.｛suname｝fullnamestorejavascrīpt.｛Math.round(Math.PI*100)/100｝PIstoreValueinputLocatorvariableName

把指定的input中的值保存到变量中

storeValueuserNameuserIDtypeuserName$.｛userID｝ storeText, storeAttribute storeText(elementLocator, variablename) 把指定元素的文本值赋予给变量 storeTextcurrentDateexpectedStartDateverifyValuestartDate$.｛expectedStartDate｝

storeAttribute( .｛｝elementLocator@attributeName,variableName.｛ ｝) 把指定元素的属性的值赋予给变量

storeAttributeinput1@class classOfInput1verifyAttributeinput2@class$.｛classOfInput1｝ chooseCancel.., answer.. chooseCancelOnNextConfirmation() - 当下次Javascrīpt弹出confirm对话框的时候,让selenium选择Cancel - 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样 chooseCancelOnNextConfirmation

- 如果已经运行过该命令，当下一次又有confirm对话框出现时，也会同样地再次选择Cancel answerOnNextPrompt(answerString) - 在下次Javascrīpt弹出prompt提示框时，赋予其anweerString的值，并选择确定

answerOnNextPromptKangaroo

三、 Assertions 允许用户去检查当前状态。两种模式: Assert 和 Verify， 当Assert失败，则退出测试；当Verify失败，测试会继续运行。

assertLocation, assertTitle assertLocation(relativeLocation) 判断当前是在正确的页面 verifyLocation/mypage assertLocation/mypage assertTitle(titlePattern) 检查当前页面的title是否正确 verifyTitleMy Page assertTitleMy Page assertValue assertValue(inputLocator, valuePattern) - 检查input的值 - 对于 checkbox或radio，如果已选择，则值为"on",反之为"off" verifyValuenameFieldJohn SmithassertValuedocument.forms[2].nameFieldJohn Smith assertSelected, assertSelectedOptions assertSelected(selectLocator, optionSpecifier) 检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同 verifySelecteddropdown2John SmithverifySelecteddorpdown2value=js*123assertSelecteddocument.forms[2].dropDownlabel=J*SmithassertSelecteddocument.forms[2].dropDownindex=0 assertSelectOptions(selectLocator, optionLabelList) - 检查下拉菜单中的选项的文本是否和optionLabelList相同 - optionLabelList是以逗号分割的一个字符串 verifySelectOptionsdropdown2John Smith,Dave BirdassertSelectOptionsdocument.forms[2].dropdownSmith,J,Bird,D assertText assertText(elementLocator,textPattern) - 检查指定元素的文本 - 只对有包含文本的元素生效 - 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本 verifyTextstatusMessageSuccessfulassertText//div[@id='foo']//h1Successful assertTextPresent, assertAttribute assertTextPresent(text) 检查在当前给用户显示的页面上是否有出现指定的文本 verifyTextPresentYou are now logged in assertTextPresentYou are now logged in assertAttribute( .｛｝elementLocator@attributeName.｛ ｝, ValuePattern) 检查当前指定元素的属性的值 verifyAttributetxt1@classbigAndBlodassertAttributedocument.images[0]@altalt-textverifyAttribute//img[@id='foo']/altalt-text assertTextPresent, etc. assertTextPresent(text) assertTextNotPresent(text) assertElementPresent(elementLocator) verifyElementPresent submitButton assertElementPresent //img[@alt='foo'] assertElementNotPresent(elementLocator) assertTable assertTable(cellAddress, valuePattern) - 检查table里的某个cell中的值 - cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始 verifyTablemyTable.1.6SubmittedassertTableresults0.213 assertVisible, nonVisible assertVisible(elementLocator) - 检查指定的元素是否可视的 - 隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none' verfyVisiblepostcode assertVisiblepostcode assertNotVisible(elementLocator) verfyNotVisible postcode assertNotVisible postcode Editable, non-editable assertEditable(inputLocator) 检查指定的input是否可以编辑 verifyEditableshape assertEditablecolour assertNotEditable(inputLocator) 检查指定的input是否不可以编辑assertAlert assertAlert(messagePattern) - 检查Javascrīpt是否有产生带指定message的alert对话框 - alert产生的顺序必须与检查的顺序一致 - 检查alert时会产生与手动点击'OK'按钮一样的效果。如果一个alert产生了，而你却没有去检查它，selenium会在下个action中报错。 - 注意：Selenium 不支持 Javascrīpt 在onload()事件时 调用alert();在这种情况下，Selenium需要你自己手动来点击OK.assertConfirmation assertConfirmation(messagePattern) - 检查Javascrīpt是否有产生带指定message的confirmation对话框和alert情况一样，confirmation对话框也必须在它们产生的时候进行检查 - 默 认情况下，Selenium会让confirm() 返回true, 相当于手动点击Ok按钮的效果。你能够通过chooseCancelOnNextConfirmation命令让confirm()返回false.同样 地，如果一个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错 - 注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框 - 注意：Selenium不支持在onload()事件时调用confirmation对话框，在这种情况下，会出现显示confirmatioin对话框，并需要你自己手动点击。 assertPrompt assertPrompt(messagePattern) - 检查Javascrīpt是否有产生带指定message的Prompt对话框 - 你检查的prompt的顺序Prompt对话框产生的顺序必须相同 - 必须在verifyPrompt之前调用answerOnNextPrompt命令 - 如果prompt对话框出现了但你却没有检查，则Selenium会在下个action中报错 answerOnNextPromptJoe clickid=delegate verifyPromptDelegate to who?

四、 Parameters and Variables 参数和变量的声明范围由简单的赋值到Javascrīpt表达式赋值。 Store，storeValue 和storeText 为下次访问保存值。 在Selenium内部是用一个叫storeVars的map来保存变量名。

Variable Substitution 变量替换 提供了一个简单的方法去访问变量,语法 $.｛xxx｝ storeMrtitlestoreValuenameFieldsurnamestore$.｛title｝ $.｛suname｝fullnametypetextElementFull name is: $.｛fullname｝ Javascrīpt Evaluation Javascrīpt赋值 你能用Javascrīpt来构建任何你所需要的值。 这个参数是以javascrīpt开头，语法是 javascrīpt.｛'with a trailing'｝。 可以通过Javascrīpt表达式给某元素赋值。 storejavascrīpt.｛'merchant'+(new Date()).getTime()｝merchantIdtypetextElementjavascrīpt.｛storedVars['merchantId'].toUpperCase()｝ Generating Unique values 产生唯一值. 问题：你需要唯一的用户名 解决办法: 基于时间来产生用户名，如'fred'+(new Date().getTime())