51Testing软件测试论坛

标题: Selenium中文手册 [打印本页]

作者: keynes_2005 时间: 2007-1-11 18:39
标题: 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=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())

作者: dugang 时间: 2007-3-14 22:33
标题: 这个工具站内有下载吗？
这个工具站内有下载吗？

作者: fly_sky1999 时间: 2007-3-19 23:00
标题: 请问哪里有下载
请问哪里有下载

作者: ami冰河 时间: 2007-3-21 10:36
下载地址：（官网，是免费的哦）
http://www.openqa.org/selenium/

作者: logtime 时间: 2007-6-15 11:46
这个东西是用来做什么的啊？

作者: dqf 时间: 2007-7-11 16:24
有没有实例呀？

作者: autost 时间: 2007-8-3 17:04
标题: 楼主有没有这方面应用实例？
我学习新工具比较喜欢从实例入手，如果楼主有这样的例子，那就完美了！

作者: lawgend 时间: 2007-9-9 16:53
在selenium的官方网站上面有user guide以及相关的doc, addr: http://www.openqa.org

作者: yangzx554 时间: 2007-12-6 16:49
大家对新工具多感觉到不错，但是我们有多少用的哦啊实际环境去了呢，中国测试道路还远呢至少web这块

作者: gaobugu 时间: 2008-1-15 21:41
同意楼上的。现在的开源工具很多，但是在实际工作中，用得很少。这样学习起来，也就没有具体的目标了。

作者: guijia 时间: 2008-2-12 15:15
请问这个能否实现左面显示出操作还是在进程中完成测试呢

作者: lyn11091 时间: 2008-3-31 23:54
Selenium 是 ThoughtWorks 创建，捐赠并支持的Web自动测试框架。

建议大家先用Selenium IDE 上手，之后可以用Selenium RC 自己写测试脚本。

作者: xinyu2119 时间: 2008-4-8 12:31
Selenium很好用的东西，几乎对所有的Web都支持，特别是一些java写的一些特殊的控件，因为是免费开源的，所以二次开发性比较强，遇到一些不能识别的控件，可以扩充它的IDE，灵活的运用是它的关键。一些商业化的自动化工具都把自己的IDE写的很死，虽然表面上支持的多了，但是缺少了其灵活性。还有一点值得提倡的就是，Selenium 可以用多种语言来写自己的script，C#，java，Ruby等等，你可以选择你比较熟悉的语言来应用到项目中。另外如果遇到实在不能识别的控件了，还可以用js来对其进行操作。所以我说几乎对所有的web页面都能支持。

作者: taziji 时间: 2008-5-16 05:32
Selenium 二次开发性还是很强的，可以支持各种语言，最近也在用Selenium做自动化测试，配合NUNIT的famework，用C#编译

作者: jessie_xuan 时间: 2008-5-29 10:44
标题: 如何得到新开窗口的title
如何得到新开窗口的title

我用assertTitle得到的是原来窗口的：（

作者: hifree 时间: 2008-6-4 13:51
标题: 简单的使用SELENIUM IDE 执行 BUSINESS OPERATION
最近分配到一项测试任务，其中很花费时间的是首先要在该系统中执行很多重复的业务操作，本人认为如果单纯手工点击的话，很浪费时间也很机械，就使用SELENIUM IDE 录制下了完整的业务流程，修改其中部分代码（CTRL V+ C ，因为许多业务操作只是某些属性的赋值不同，流程完全一致） ,使用SELENIU 自动执行修改后的脚本（即.html 文件），极大的提高了productivity & quality

我只用到了SELENIU IDE 自动执行的功能，对RC的功能很是期盼，希望有用过的朋友能够讲解一下，PS网上关于RC的资料太少了，我从官网上下了API ,可具体怎么使用呢？？像编写JAVA程序一样？？作为独立的应用？？希望高人给与指点

作者: hifree 时间: 2008-6-18 10:35
网上搜到的：
http://www.javaeye.com/topic/36879
个人理解： selenium rc 主要用来做验收测试，但这种验收测试是基于代码级别的，需要在ECLIPSE 等环境中结合单元测试来做·～～～～请问有谁是测试人员在实际工作中使用过 RC做测试啊？？？？？

作者: jessie_xuan 时间: 2008-6-26 10:49
标题: 请给个例子吧。

原帖由 jessie_xuan 于 2008-5-29 10:44 发表
如何得到新开窗口的title

我用assertTitle得到的是原来窗口的：（

请给个例子吧。。

作者: gaobugu 时间: 2008-9-10 13:31
一直搞不懂selenium怎么用？感觉很难入手

作者: sufen2315 时间: 2008-12-5 12:08
如果能支持IE浏览器的录制功能就好了
我们的系统和firefox兼容不好。
期待高手！

作者: 10885 时间: 2009-1-13 16:56

原帖由 sufen2315 于 2008-12-5 12:08 发表
如果能支持IE浏览器的录制功能就好了
我们的系统和firefox兼容不好。
期待高手！

可以使用IDE录制脚本，然后使用RC，RC支持IE浏览器

作者: sufen2315 时间: 2009-3-2 17:06
标题: 回复 21# 的帖子
楼上的能再详细点么?

作者: yanmou626 时间: 2009-6-22 09:51
selenium RC结合CruiseControl或者teamCity这类持续集成工具，用java的话，再懂点ant，这样的web测试脚本那叫一个强大

作者: yanmou626 时间: 2009-6-24 13:20
标题: 问下搂主
我用selenium rc 时碰到个问题，就是canvas 得tag，怎么比较，它不是个图片，你用右键保存不了的，用别的工具可以把这个对象截成图片去比较，用slenium怎么搞？

作者: GeorgeWangLC 时间: 2010-1-3 21:09
顶一下

作者: crg044768 时间: 2010-11-15 11:54
bucuosdfdsfdsfds

作者: jooben 时间: 2011-2-8 18:36
好东西,要顶哟,呵呵

作者: 路得luter 时间: 2013-11-5 11:08
回复 14# taziji

你好，我是新手，公司的程序是C#写的。现在我想用selenium进行自动化测试。测试脚本用C#是不是最好？可是我在网上找不到C#编程语言编写selenium测试的教程，多数都是java或phthyon的教程，十分迷茫呀！

我在想对用C#开发的软件如果用selenium进行自动化测试用java或者Python编程可不可以？如果可以的话是不是我搭建了java的环境，为了被测程序我还得搭建.net环境吗？？？可以兼容吗？

作者: Miss_love 时间: 2013-11-15 13:46
selenium不了解，过来学习学习。

欢迎光临 51Testing软件测试论坛 (http://bbs.51testing.com/)