Selenium Core命令指南
SeleniumCore命令指南
参考地址:http://release.seleniumhq.org/selenium-core/1.0/reference.html
一、Commands(命令)
•Action
对当前状态进行操作
失败时，停止测试
•Assertion
校验是否有产生正确的值
•ElementLocators
指定HTML中的某元素
•Patterns
用于模式匹配
1.ElementLocators(元素定位器)
•id=id
idlocator指定HTML中的唯一id的元素
•name=name
namelocator指定HTML中相同name的元素中的第一个元素
•identifier=id
identifierlocator首先查找HTML是否存在该id的元素,若不存在，查找第一个该name的元素
•dom=javascriptExpression
domlocator用JavaScript表达式来定位HTML中的元素,注意必须要以"document"开头
例如:
dom=document.forms['myForm'].myDropdown
dom=document.images[56]
•xpath=xpathExpression
xpathlocator用XPath表达式来定位HTML中的元素,必须注意要以"//"开头
例如：
xpath=//img[@alt='Theimagealttext']
xpath=//table[@id='table1']//tr[4]/td[2]
•link=textPattern
linklocator用link来选择HTML中的连接或锚元素
例如:
link=Thelinktext
•在没有locator前序的情况下Withoutalocatorprefix,Seleniumuses:
如果以"document."开头，则默认是使用domlocator，如果是以"//"开头，则默认使用xpathlocator,其余情况均认作identifierlocator
2.StringMatchingPatterns(字符串匹配模式)
•glob:patthern
glob模式，用通配符"*"代表任意长度字符，"?"代表一个字符
•regexp:regexp
正则表达式模式，用JavaScript正则表达式的形式匹配字符串
•exact:string
精确匹配模式，精确匹配整个字符串，不能用通配符
•在没有指定字符串匹配前序的时候，selenium默认使用golb匹配模式
3.SelectOptionSpecifiers(Select选项指定器)
•label=labelPattern
通过匹配选项中的文本指定选项
例如：label=regexp:^[Oo]ther
•value=valuePattern
通过匹配选项中的值指定选项
例如：value=other
•id=id
通过匹配选项的id指定选项
例如:id=option1
•index=index
通过匹配选项的序号指定选项，序号从0开始
例如：index=2
•在没有选项选择前序的情况下，默认是匹配选项的文本
二、Actions
描述了用户所会作出的操作。
Action有两种形式:action和actionAndWait,action会立即执行，而actionAndWait会假设需要较长时间才能得到该action的相响，而作出等待，open则是会自动处理等待时间。
•click
click(elementLocator)
-点击连接,按钮，复选和单选框
-如果点击后需要等待响应，则用"clickAndWait"
-如果是需要经过JavaScript的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。clickaCheckbox
clickAndWaitsubmitButton
clickAndWaitanyLink
•open
open(url)
-在浏览器中打开URL,可以接受相对和绝对路径两种形式
-注意：该URL必须在与浏览器相同的安全限定范围之内open/mypage
openhttp://localhost/
•type
type(inputLocator,value)
-模拟人手的输入过程，往指定的input中输入值
-也适合给复选和单选框赋值
-在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本typenameFieldJohnSmith
typeAndWaittextBoxThatSubmitsOnChangenewValue
•select
select(dropDownLocator,optionSpecifier)
-根据optionSpecifier选项选择器来选择一个下拉菜单选项
-如果有多于一个选择器的时候，如在用通配符模式，如"f*b*",或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值selectdropDownAustralianDollars
selectdropDownindex=0
selectAndWaitcurrencySelectorvalue=AUD
selectAndWaitcurrencySelectorlabel=AuslianD*rs
•goBack,close
goBack()
模拟点击浏览器的后退按钮
close()
模拟点击浏览器关闭按钮
•selectWindow
select(windowId)
-选择一个弹出窗口
-当选中那个窗口的时候，所有的命令将会转移到那窗口中执行selectWindowmyPopupWindow
selectWindownull
•pause
pause(millisenconds)
-根据指定时间暂停Selenium脚本执行
-常用在调试脚本或等待服务器段响应时pause5000
pause2000
•fireEvent
fireEvent(elementLocatore,evenName)
模拟页面元素事件被激活的处理动作fireEventtextFieldfocus
fireEventdropDownblur
•waitForCondition
waitForCondition(JavaScriptSnippet,time)
-在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待waitForConditionvarvalue=selenium.getText("foo");value.match(/bar/);3000
•waitForValue
waitForValue(inputLocator,value)
-等待某input(如hiddeninput)被赋予某值，
-会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞waitForValuefinishIndicationisfinished
•store,stroreValue
store(valueToStore,variablename)
保存一个值到变量里。
该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量storeMrJohnSmithfullname
store$.｛title｝$.｛firstname｝$.｛suname｝fullname
storejavascript.｛Math.round(Math.PI*100)/100｝PI
storeValueinputLocatorvariableName
把指定的input中的值保存到变量中
storeValueuserNameuserID
typeuserName$.｛userID｝
•storeText,storeAttribute
storeText(elementLocator,variablename)
把指定元素的文本值赋予给变量storeTextcurrentDateexpectedStartDate
verifyValuestartDate$.｛expectedStartDate｝
storeAttribute(.｛｝elementLocator@attributeName,variableName.｛｝)
把指定元素的属性的值赋予给变量
storeAttributeinput1@classclassOfInput1
verifyAttributeinput2@class$.｛classOfInput1｝
•chooseCancel..,answer..
chooseCancelOnNextConfirmation()
-当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
-如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样chooseCancelOnNextConfirmation
-如果已经运行过该命令，当下一次又有confirm对话框出现时，也会同样地再次选择Cancel
answerOnNextPrompt(answerString)
-在下次JavaScript弹出prompt提示框时，赋予其anweerString的值，并选择确定
answerOnNextPromptKangaroo
三、Assertions
允许用户去检查当前状态。两种模式:Assert和Verify，当Assert失败，则退出测试；当Verify失败，测试会继续运行。
•assertLocation,assertTitle
assertLocation(relativeLocation)
判断当前是在正确的页面verifyLocation/mypage
assertLocation/mypage
•assertTitle(titlePattern)
检查当前页面的title是否正确verifyTitleMyPage
assertTitleMyPage
•assertValue
assertValue(inputLocator,valuePattern)
-检查input的值
-对于checkbox或radio，如果已选择，则值为"on",反之为"off"verifyValuenameFieldJohnSmith
assertValuedocument.forms[2].nameFieldJohnSmith
•assertSelected,assertSelectedOptions
assertSelected(selectLocator,optionSpecifier)
检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同verifySelecteddropdown2JohnSmith
verifySelecteddorpdown2value=js*123
assertSelecteddocument.forms[2].dropDownlabel=J*Smith
assertSelecteddocument.forms[2].dropDownindex=0
•assertSelectOptions(selectLocator,optionLabelList)
-检查下拉菜单中的选项的文本是否和optionLabelList相同
-optionLabelList是以逗号分割的一个字符串verifySelectOptionsdropdown2JohnSmith,DaveBird
assertSelectOptionsdocument.forms[2].dropdownSmith,J,Bird,D
•assertText
assertText(elementLocator,textPattern)
-检查指定元素的文本
-只对有包含文本的元素生效
-对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本verifyTextstatusMessageSuccessful
assertText//div[@id='foo']//h1Successful
•assertTextPresent,assertAttribute
assertTextPresent(text)
检查在当前给用户显示的页面上是否有出现指定的文本verifyTextPresentYouarenowloggedin
assertTextPresentYouarenowloggedin
•assertAttribute(.｛｝elementLocator@attributeName.｛｝,ValuePattern)
检查当前指定元素的属性的值verifyAttributetxt1@classbigAndBlod
assertAttributedocument.images[0]@altalt-text
verifyAttribute//img[@id='foo']/altalt-text
•assertTextPresent,etc.
assertTextPresent(text)
assertTextNotPresent(text)
assertElementPresent(elementLocator)verifyElementPresentsubmitButton
assertElementPresent//img[@alt='foo']assertElementNotPresent(elementLocator)
•assertTable
assertTable(cellAddress,valuePattern)
-检查table里的某个cell中的值
-cellAddress的语法是tableName.row.column,注意行列序号都是从0开始verifyTablemyTable.1.6Submitted
assertTableresults0.213
•assertVisible,nonVisible
assertVisible(elementLocator)
-检查指定的元素是否可视的
-隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none'verfyVisiblepostcode
assertVisiblepostcode
•assertNotVisible(elementLocator)verfyNotVisiblepostcode
assertNotVisiblepostcode
•Editable,non-editable
assertEditable(inputLocator)
检查指定的input是否可以编辑verifyEditableshape
assertEditablecolour
•assertNotEditable(inputLocator)
检查指定的input是否不可以编辑
•assertAlert
assertAlert(messagePattern)
-检查JavaScript是否有产生带指定message的alert对话框
-alert产生的顺序必须与检查的顺序一致
-检查alert时会产生与手动点击'OK'按钮一样的效果。如果一个alert产生了，而你却没有去检查它，selenium会在下个action中报错。
-注意：Selenium不支持JavaScript在onload()事件时调用alert();在这种情况下，Selenium需要你自己手动来点击OK.
•assertConfirmation
assertConfirmation(messagePattern)
-检查JavaScript是否有产生带指定message的confirmation对话框和alert情况一样，confirmation对话框也必须在它们产生的时候进行检查
-默认情况下，Selenium会让confirm()返回true,相当于手动点击Ok按钮的效果。你能够通过chooseCancelOnNextConfirmation命令让confirm()返回false.同样地，如果一个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错
-注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框
-注意：Selenium不支持在onload()事件时调用confirmation对话框，在这种情况下，会出现显示confirmatioin对话框，并需要你自己手动点击。
•assertPrompt
assertPrompt(messagePattern)
-检查JavaScript是否有产生带指定message的Prompt对话框
-你检查的prompt的顺序Prompt对话框产生的顺序必须相同
-必须在verifyPrompt之前调用answerOnNextPrompt命令
-如果prompt对话框出现了但你却没有检查，则Selenium会在下个action中报错answerOnNextPromptJoe
clickid=delegate
verifyPromptDelegatetowho?
四、ParametersandVariables
参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。
Store，storeValue和storeText为下次访问保存值。
在Selenium内部是用一个叫storeVars的map来保存变量名。
•VariableSubstitution变量替换
提供了一个简单的方法去访问变量,语法$.｛xxx｝storeMrtitle
storeValuenameFieldsurname
store$.｛title｝$.｛suname｝fullname
typetextElementFullnameis:$.｛fullname｝
•JavaScriptEvaluationJavaScript赋值
你能用JavaScript来构建任何你所需要的值。
这个参数是以javascript开头，语法是javascript.｛'withatrailing'｝。
可以通过JavaScript表达式给某元素赋值。storejavascript.｛'merchant'+(newDate()).getTime()｝merchantId
typetextElementjavascript.｛storedVars['merchantId'].toUpperCase()｝
•GeneratingUniquevalues产生唯一值.
问题：你需要唯一的用户名
解决办法:基于时间来产生用户名，如'fred'+(newDate().getTime())