五、Selenium 中文手册
Commands (命令)
Action
对当前状态进行操作
失败时,停止测试
对当前状态进行操作
失败时,停止测试
Assertion
校验是否有产生正确的值
校验是否有产生正确的值
Element Locators
指定HTML中的某元素
指定HTML中的某元素
Patterns
用于模式匹配
用于模式匹配
1. Element Locators (元素定位器)
id=id
id locator 指定HTML中的唯一id的元素
id locator 指定HTML中的唯一id的元素
name=name
name locator指定 HTML中相同name的元素中的第一个元素
name locator指定 HTML中相同name的元素中的第一个元素
identifier=id
identifier locator 首先查HTML是否存在该id的元素, 若不存在,查第一个该name的元素
identifier locator 首先查HTML是否存在该id的元素, 若不存在,查第一个该name的元素
dom=javascriptExpression
dom locator用JavaScript表达式来定位HTML中的元素,注意必须要以"document"开头
例如:
dom=document.forms['myForm'].myDropdown
dom=document.images[56]
dom locator用JavaScript表达式来定位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]
例如:
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
link locator 用link来选择HTML中的连接或锚元素
例如:
link=The link text
在没有locator前序的情况下 Without a locator prefix, Selenium uses:
如果以"document."开头,则默认是使用dom locator,如果是以"//"开头,则默认使用xpath locator,其余情况均认作identifier locator
如果以"document."开头,则默认是使用dom locator,如果是以"//"开头,则默认使用xpath locator,其余情况均认作identifier locator
2. String Matching Patterns (字符串匹配模式)
glob:patthern
glob模式,用通配符"*"代表任意长度字符,"?"代表一个字符
glob模式,用通配符"*"代表任意长度字符,"?"代表一个字符
regexp:regexp
正则表达式模式,用JavaScript正则表达式的形式匹配字符串
正则表达式模式,用JavaScript正则表达式的形式匹配字符串
exact:string
精确匹配模式,精确匹配整个字符串,不能用通配符
精确匹配模式,精确匹配整个字符串,不能用通配符
在没有指定字符串匹配前序的时候,selenium 默认使用golb匹配模式
selenium怎么使用3. Select Option Specifiers (Select选项指定器)
label=labelPattern
通过匹配选项中的文本指定选项
例如:label=regexp:^[Oo]ther
通过匹配选项中的文本指定选项
例如:label=regexp:^[Oo]ther
value=valuePattern
通过匹配选项中的值指定选项
例如:value=other
通过匹配选项中的值指定选项
例如:value=other
id=id
通过匹配选项的id指定选项
例如: id=option1
通过匹配选项的id指定选项
例如: id=option1
index=index
通过匹配选项的序号指定选项,序号从0开始
例如:index=2
通过匹配选项的序号指定选项,序号从0开始
例如:index=2
在没有选项选择前序的情况下,默认是匹配选项的文本
Actions
描述了用户所会作出的操作。
Action 有两种形式: action和actionAndWait, action会立即执行,而actionAndWait会假设需要较长时间才能得到该action的相响,而作出等待,open则是会自动处理等待时间。
Action 有两种形式: action和actionAndWait, action会立即执行,而actionAndWait会假设需要较长时间才能得到该action的相响,而作出等待,open则是会自动处理等待时间。
click
click(elementLocator)
-
click(elementLocator)
-
点击连接,按钮,复选和单选框
- 如果点击后需要等待响应,则用"clickAndWait"
- 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作,则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。
- 如果点击后需要等待响应,则用"clickAndWait"
- 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作,则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。
click | aCheckbox | |
clickAndWait | submitButton | |
clickAndWait | anyLink | |
open
open(url)
- 在浏览器中打开URL,可以接受相对和绝对路径两种形式
- 注意:该URL必须在与浏览器相同的安全限定范围之内
open(url)
- 在浏览器中打开URL,可以接受相对和绝对路径两种形式
- 注意:该URL必须在与浏览器相同的安全限定范围之内
open | /mypage | |
open | localhost/ | |
type
type(inputLocator, value)
- 模拟人手的输入过程,往指定的input中输入值
- 也适合给复选和单选框赋值
- 在这个例子中,则只是给钩选了的复选框赋值,注意,而不是改写其文本
type(inputLocator, value)
- 模拟人手的输入过程,往指定的input中输入值
- 也适合给复选和单选框赋值
- 在这个例子中,则只是给钩选了的复选框赋值,注意,而不是改写其文本
type | nameField | John Smith |
typeAndWait | textBoxThatSubmitsOnChange | newValue |
select
select(dropDownLocator, optionSpecifier)
- 根据optionSpecifier选项选择器来选择一个下拉菜单选项
- 如果有多于一个选择器的时候,如在用通配符模式,如"f*b*",或者超过一个选项有相同的文本或值,则会选择第一个匹配到的值
select(dropDownLocator, optionSpecifier)
- 根据optionSpecifier选项选择器来选择一个下拉菜单选项
- 如果有多于一个选择器的时候,如在用通配符模式,如"f*b*",或者超过一个选项有相同的文本或值,则会选择第一个匹配到的值
select | dropDown | Australian Dollars |
select | dropDown | index=0 |
selectAndWait | currencySelector | value=AUD |
selectAndWait | currencySelector | label=Auslian D*rs |
goBack,close
goBack()
模拟点击浏览器的后退按钮
close()
模拟点击浏览器关闭按钮
goBack()
模拟点击浏览器的后退按钮
close()
模拟点击浏览器关闭按钮
selectWindow
select(windowId)
- 选择一个弹出窗口
- 当选中那个窗口的时候,所有的命令将会转移到那窗口中执行
select(windowId)
- 选择一个弹出窗口
- 当选中那个窗口的时候,所有的命令将会转移到那窗口中执行
selectWindow | myPopupWindow | |
selectWindow | null | |
pause
pause(millisenconds)
-
pause(millisenconds)
-
根据指定时间暂停Selenium脚本执行
- 常用在调试脚本或等待服务器段响应时
- 常用在调试脚本或等待服务器段响应时
pause | 5000 | |
pause | 2000 | |
fireEvent
fireEvent(elementLocatore,evenName)
模拟页面元素事件被激活的处理动作
fireEvent(elementLocatore,evenName)
模拟页面元素事件被激活的处理动作
fireEvent | textField | focus |
fireEvent | dropDown | blur |
waitForCondition
waitForCondition(JavaScriptSnippet,time)
- 在限定时间内,等待一段JavaScript代码返回true值,超时则停止等待
waitForCondition(JavaScriptSnippet,time)
- 在限定时间内,等待一段JavaScript代码返回true值,超时则停止等待
waitForCondition | var Text("foo"); value.match(/bar/); | 3000 |
waitForValue
waitForValue(inputLocator, value)
- 等待某input(如hidden input)被赋予某值,
- 会轮流检测该值,所以要注意如果该值长时间一直不赋予该input该值的话,可能会导致阻塞
waitForValue(inputLocator, value)
- 等待某input(如hidden input)被赋予某值,
- 会轮流检测该值,所以要注意如果该值长时间一直不赋予该input该值的话,可能会导致阻塞
waitForValue | finishIndication | isfinished |
store,stroreValue
store(valueToStore, variablename)
保存一个值到变量里。
该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量
store(valueToStore, variablename)
保存一个值到变量里。
该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量
store | Mr John Smith | fullname |
store | $.{title} $.{firstname} $.{suname} | fullname |
store | javascript.{und(Math.PI*100)/100} | PI |
storeValue | inputLocator | variableName |
把指定的input中的值保存到变量中
storeValue | userName | userID |
type | userName | $.{userID} |
storeText, storeAttribute
storeText(elementLocator, variablename)
把指定元素的文本值赋予给变量
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()
- 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
- 如果没有该命令时,遇到confirm对话框Selenium默认返回true,如手动选择OK按钮一样
chooseCancelOnNextConfirmation | ||
- 如果已经运行过该命令,当下一次又有confirm对话框出现时,也会同样地再次选择Cancel
answerOnNextPrompt(answerString)
- 在下次JavaScript弹出prompt提示框时,赋予其anweerString的值,并选择确定
answerOnNextPrompt(answerString)
- 在下次JavaScript弹出prompt提示框时,赋予其anweerString的值,并选择确定
answerOnNextPrompt | Kangaroo | |
Assertions
允许用户去检查当前状态。两种模式: Assert 和 Verify,当Assert失败,则退出测试;当Verify失败,测试会继续运行。
assertLocation, assertTitle
assertLocation(relativeLocation)
判断当前是在正确的页面
assertLocation(relativeLocation)
判断当前是在正确的页面
verifyLocation | /mypage | |
assertLocation | /mypage | |
assertTitle(titlePattern)
检查当前页面的title是否正确
检查当前页面的title是否正确
verifyTitle | My Page | |
assertTitle | My Page | |
assertValue
assertValue(inputLocator, valuePattern)
-
assertValue(inputLocator, valuePattern)
-
检查input的值
- 对于 checkbox或radio,如果已选择,则值为"on",反之为"off"
- 对于 checkbox或radio,如果已选择,则值为"on",反之为"off"
verifyValue | nameField | John Smith |
assertValue | document.forms[2].nameField | John Smith |
assertSelected, assertSelectedOptions
assertSelected(selectLocator, optionSpecifier)
检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同
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是以逗号分割的一个字符串
- 检查下拉菜单中的选项的文本是否和optionLabelList相同
- optionLabelList是以逗号分割的一个字符串
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论