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