Selenium的中⽂⼿册〔转载〕
Selenium中⽂⼿册
⼀、  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 默认使⽤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
描述了⽤户所会作出的操作。
Action 有两种形式: action和actionAndWait, action会⽴即执⾏，⽽actionAndWait会假设需要较长时间才能得到该action的相响，⽽作出等待，open则是会⾃动处理等待时间。
click
click(elementLocator)
- 点击连接，按钮，复选和单选框
- 如果点击后需要等待响应，则⽤"clickAndWait"
- 如果是需要经过Javascrīpt的alert或confirm对话框后才能继续操作，则需要调⽤verify或assert来告诉Selenium你期望对对话框进⾏什么操作。  click  aCheckbox
clickAndWait  submitButton
clickAndWait  anyLink
open
open(url)
- 在浏览器中打开URL，可以接受相对和绝对路径两种形式
- 注意：该URL必须在与浏览器相同的安全限定范围之内  open  /mypage
open
type
type(inputLocator, value)
- 模拟⼈⼿的输⼊过程，往指定的input中输⼊值
- 也适合给复选和单选框赋值
-
在这个例⼦中，则只是给钩选了的复选框赋值，注意，⽽不是改写其⽂本  type  nameField  John Smith
typeAndWait  textBoxThatSubmitsOnChange  newValue
select
select(dropDownLocator, optionSpecifier)
- 根据optionSpecifier选项选择器来选择⼀个下拉菜单选项
- 如果有多于⼀个选择器的时候，如在⽤通配符模式，如"f*b*"，或者超过⼀个选项有相同的⽂本或值，则会选择第⼀个匹配到的值  select  dr opDown  Australian Dollars
select  dropDown  index=0
selectAndWait  currencySelector  value=AUD
selectAndWait  currencySelector  label=Auslian D*rs
goBack,close
goBack()
模拟点击浏览器的后退按钮
close()
模拟点击浏览器关闭按钮
selectWindow
select(windowId)
- 选择⼀个弹出窗⼝
- 当选中那个窗⼝的时候，所有的命令将会转移到那窗⼝中执⾏  selectWindow  myPopupWindow
selectWindow  null
pause
pause(millisenconds)
-
根据指定时间暂停Selenium脚本执⾏
- 常⽤在调试脚本或等待服务器段响应时  pause  5000
pause  2000
fireEvent
fireEvent(elementLocatore,evenName)
模拟页⾯元素事件被激活的处理动作  fireEvent  textField  focus
fireEvent  dropDown  blur
waitForCondition
waitForCondition(JavascrīptSnippet,time)
- 在限定时间内，等待⼀段Javascrīpt代码返回true值，超时则停⽌等待  waitForCondition  var Text("foo"); value.match(/ bar/);  3000
waitForValue
waitForValue(inputLocator, value)
- 等待某input(如hidden input)被赋予某值，
- 会轮流检测该值，所以要注意如果该值长时间⼀直不赋予该input该值的话，可能会导致阻塞  waitForValue  finishIndication  isfinished  store,stroreValue
store(valueToStore, variablename)selenium怎么使用
保存⼀个值到变量⾥。
该值可以由⾃变量组合⽽成或通过Javascrīpt表达式赋值给变量  store  Mr John Smith  fullname
store  $.｛title｝ $.｛firstname｝ $.｛suname｝  fullname
store  javascrīpt.｛und(Math.PI*100)/100｝  PI
storeValue  inputLocator  variableName
把指定的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()
-
当下次Javascrīpt弹出confirm对话框的时候，让selenium选择Cancel
- 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如⼿动选择OK按钮⼀样  chooseCancelOnNextConfirmation
- 如果已经运⾏过该命令，当下⼀次⼜有confirm对话框出现时，也会同样地再次选择Cancel
answerOnNextPrompt(answerString)
- 在下次Javascrīpt弹出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  Succe ssful
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的语法是lumn, 注意⾏列序号都是从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)
- 检查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命令让confi rm()返回false.同样地，如果⼀个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错
- 注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框
- 注意：Selenium不⽀持在onload()事件时调⽤confirmation对话框，在这种情况下，会出现显⽰confirmatioin对话框，并需要你⾃⼰⼿动点击。
assertPrompt
assertPrompt(messagePattern)
- 检查Javascrīpt是否有产⽣带指定message的Prompt对话框
- 你检查的prompt的顺序Prompt对话框产⽣的顺序必须相同
- 必须在verifyPrompt之前调⽤answerOnNextPrompt命令
- 如果prompt对话框出现了但你却没有检查，则Selenium会在下个action中报错  answerOnNextPrompt  Joe
click  id=delegate
verifyPrompt  Delegate to who?
四、 Parameters and Variables
参数和变量的声明范围由简单的赋值到Javascrīpt表达式赋值。
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｝
Javascrīpt Evaluation Javascrīpt赋值
你能⽤Javascrīpt来构建任何你所需要的值。
这个参数是以javascrīpt开头，语法是 javascrīpt.｛'with a trailing'｝。
可以通过Javascrīpt表达式给某元素赋值。  store  javascrīpt.｛'merchant'+(new Date()).getTime()｝  merchantId
type  textElement  javascrīpt.｛storedVars['merchantId'].toUpperCase()｝
Generating Unique values 产⽣唯⼀值.
问题：你需要唯⼀的⽤户名
解决办法: 基于时间来产⽣⽤户名，如'fred'+(new Date().getTime())Selenium中⽂⼿册
⼀、  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 默认使⽤golb 匹配模式
3. Select Option Specifiers (Select选项指定器)
label=labelPattern
通过匹配选项中的⽂本指定选项
例如：label=regexp:^[Oo]ther
value=valuePattern
通过匹配选项中的值指定选项
例如：value=other
id=id
通过匹配选项的id指定选项

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。