Selenium备忘手册 (转帖)

Selenium备忘手册

 

作者 johnsonchen 目标文章 项目日志 - 2006-09-13

    最近的项目准备用Selenium作一部分的Regression Test。在SpringSide里参考了一下，又下了个Selenium IDE玩玩，觉得还蛮容易上手，基本上不需要手动写测试代码。
    但实操起来时面对各种复杂的页面情况遇到不少麻烦。感觉Selenium 的offical documentation写的比较high level, 最后找了个though works的ppt，算得上比较全面易懂。匆匆翻译了一下，供后来者参考。

一、 格式
1. Test Case 格式

	Title
命令(Command)	目标(Target)	值(Value)
命令(Command)	目标(Target)	( )
判断(Assertion)	期望值(Expected)	实际值(Actual)

2. Test Suites 格式

 Title

 TestCase1.html

 TestCase2.html

 TestCase3.html

二、 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=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 (字符串匹配模式)

• glob:patthern
  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
描述了用户所会作出的操作。
Action 有两种形式: action和actionAndWait, action会立即执行，而actionAndWait会假设需要较长时间才能得到该action的相响，而作出等待，open则是会自动处理等待时间。

• click
  click(elementLocator)
  - 点击连接,按钮，复选和单选框
  - 如果点击后需要等待响应，则用”clickAndWait”
  - 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。
  

  click	aCheckbox
  clickAndWait	submitButton
  clickAndWait	anyLink

  
  
• open
  open(url)
  - 在浏览器中打开URL,可以接受相对和绝对路径两种形式
  - 注意：该URL必须在与浏览器相同的安全限定范围之内
  

  open	/mypage
  open	http://localhost/

  
  
• type
   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

  
  
•  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(JavaScriptSnippet,time)
  - 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待
  

  waitForCondition

  var value=selenium.getText("foo"); value.match(/bar/);

  3000

  
  
• waitForValue
  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{Math.round(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()
  - 当下次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()}

  
  
• Generating Unique values 产生唯一值.  
  问题：你需要唯一的用户名
  解决办法: 基于时间来产生用户名，如’fred’+(new Date().getTime())