把指定的input中的值保存到变量中
storeValue userName userID
type userName $.{userID}
storeText, storeAttribute
storeText(elementLocator, variablename)
把指定元素的文本值赋予给变量
storeText currentDate expectedStartDate
verifyValue startDate $.{expectedStartDate}
storeAttribute(.{}elementLocator@attributeName,variableName.{})
把指定元素的属性的值赋予给变量
storeAttribute input1@class classOfInput1
verifyAttribute input2@class $.{classOfInput1}
chooseCancel.., answer..
chooseCancelOnNextConfirmation()
-当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
-如果没有该命令时,遇到confirm对话框Selenium默认返回true,如手动选择OK按钮一样
chooseCancelOnNextConfirmation
-如果已经运行过该命令,当下一次又有confirm对话框出现时,也会同样地再次选择Cancel
answerOnNextPrompt(answerString)
- 在下次JavaScript弹出prompt提示框时,赋予其anweerString的值,并选择确定
answerOnNextPrompt Kangaroo
三、Assertions
允许用户去检查当前状态。两种模式: Assert 和 Verify,当Assert失败,则退出测试;当Verify失败,测试会继续运行。
assertLocation, assertTitle
assertLocation(relativeLocation)
判断当前是在正确的页面
verifyLocation /mypage
assertLocation /mypage
assertTitle(titlePattern)
检查当前页面的title是否正确
verifyTitle My Page
assertTitle My Page
assertValue
assertValue(inputLocator, valuePattern)
-检查input的值
-对于 checkbox或radio,如果已选择,则值为"on",反之为"off"
verifyValue nameField John Smith
assertValue document.forms[2].nameField John Smith
assertSelected, assertSelectedOptions
assertSelected(selectLocator, optionSpecifier)
检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同
verifySelected dropdown2 John Smith
verifySelected dorpdown2 value=js*123
assertSelected document.forms[2].dropDown label=J*Smith
assertSelected document.forms[2].dropDown index=0
assertSelectOptions(selectLocator, optionLabelList)
-检查下拉菜单中的选项的文本是否和optionLabelList相同
-optionLabelList是以逗号分割的一个字符串
verifySelectOptions dropdown2 John Smith,Dave Bird
assertSelectOptions document.forms[2].dropdown Smith,J,Bird,D
assertText
assertText(elementLocator,textPattern)
-检查指定元素的文本
-只对有包含文本的元素生效
-对于Mozilla类型的浏览器,用textContent取元素的文本,对于IE类型的浏览器,用innerText取元素文本
verifyText statusMessage Successful
assertText //div[@id='foo']//h1 Successful
assertTextPresent, assertAttribute
assertTextPresent(text)
检查在当前给用户显示的页面上是否有出现指定的文本
verifyTextPresent You are now logged in
assertTextPresent You are now logged in
assertAttribute(.{}elementLocator@attributeName.{}, ValuePattern)
检查当前指定元素的属性的值
verifyAttribute txt1@class bigAndBlod
assertAttribute document.images[0]@alt alt-text
verifyAttribute //img[@id='foo']/alt alt-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开始
verifyTable myTable.1.6 Submitted
assertTable results0.2 13
assertVisible, nonVisible
assertVisible(elementLocator)
-检查指定的元素是否可视的
-隐藏一个元素可以用设置css的'visibility'属性为'hidden',也可以设置'display'属性为'none'
verfyVisible postcode
assertVisible postcode
assertNotVisible(elementLocator)
verfyNotVisible postcode
assertNotVisible postcode
Editable, non-editable
assertEditable(inputLocator)
检查指定的input是否可以编辑
verifyEditable shape
assertEditable colour
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中报错
answerOnNextPrompt Joe
click id=delegate
verifyPrompt Delegate to who?
四、Parameters and Variables
参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。
Store,storeValue 和storeText 为下次访问保存值。
在Selenium内部是用一个叫storeVars的map来保存变量名。
Variable Substitution 变量替换
提供了一个简单的方法去访问变量,语法 $.{xxx}
store Mr title
storeValue nameField surname
store $.{title} $.{suname} fullname
type textElement Full name is: $.{fullname}
JavaScript. Evaluation JavaScript赋值
你能用JavaScript来构建任何你所需要的值。
这个参数是以javascript开头,语法是 javascript.{'with a trailing'}。
可以通过JavaScript表达式给某元素赋值。
store javascript.{'merchant'+(new Date()).getTime()} merchantId
type textElement javascript.{storedVars['merchantId'].toUpperCase()}