| Blog信息 |
|
blog名称:
日志总数:1304
评论数量:2242
留言数量:5
访问次数:7580931
建立时间:2006年5月29日 |
| |
|
 [集成测试]Selenium备忘手册
软件技术
lhwork 发表于 2006/11/30 13:34:07 |
| 最近的项目准备用Selenium作一部分的Regression Test。在SpringSide里参考了一下，又下了个Selenium IDE玩玩，觉得还蛮容易上手，基本上不需要手动写测试代码。 但实操起来时面对各种复杂的页面情况遇到不少麻烦。感觉Selenium 的offical documentation写的比较high level, 最后找了个though works的ppt，算得上比较全面易懂。匆匆翻译了一下，供后来者参考。一、 格式1. Test Case 格式2. Test Suites 格式 Title TestCase1.html TestCase2.html TestCase3.html 二、 Commands (命令)Action对当前状态进行操作失败时，停止测试 Assertion校验是否有产生正确的值 Element Locators 指定HTML中的某元素 Patterns用于模式匹配 1. Element Locators (元素定位器)id=idid locator 指定HTML中的唯一id的元素 name=namename locator指定 HTML中相同name的元素中的第一个元素 identifier=ididentifier locator 首先查找HTML是否存在该id的元素, 若不存在，查找第一个该name的元素 dom=javascriptExpressiondom locator用JavaScript表达式来定位HTML中的元素,注意必须要以”document”开头例如:dom=document.forms[‘myForm’].myDropdowndom=document.images[56] xpath=xpathExpressionxpath locator用 XPath 表达式来定位HTML中的元素,必须注意要以”//”开头例如：xpath=//img[@alt=’The image alt text’]xpath=//table[@id=’table1’]//tr[4]/td[2] link=textPatternlink 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:patthernglob模式，用通配符”*”代表任意长度字符，“?”代表一个字符 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则是会自动处理等待时间。clickclick(elementLocator)- 点击连接,按钮，复选和单选框- 如果点击后需要等待响应，则用”clickAndWait”- 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。 click aCheckbox clickAndWait submitButton clickAndWait anyLink openopen(url)- 在浏览器中打开URL,可以接受相对和绝对路径两种形式- 注意：该URL必须在与浏览器相同的安全限定范围之内 open /mypage open http://localhost/ type type(inputLocator, value)- 模拟人手的输入过程，往指定的input中输入值- 也适合给复选和单选框赋值- 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本 type nameField John Smith typeAndWait textBoxThatSubmitsOnChange newValue selectselect(dropDownLocator, optionSpecifier) - 根据optionSpecifier选项选择器来选择一个下拉菜单选项- 如果有多于一个选择器的时候，如在用通配符模式，如”f*b*”,或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值 select dropDown Australian Dollars select dropDown index=0 selectAndWait currencySelector value=AUD selectAndWait currencySelector label=Auslian D*rs goBack,closegoBack()模拟点击浏览器的后退按钮close()模拟点击浏览器关闭按钮selectWindowselect(windowId)- 选择一个弹出窗口- 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行 selectWindow myPopupWindow selectWindow null pausepause(millisenconds)- 根据指定时间暂停Selenium脚本执行- 常用在调试脚本或等待服务器段响应时 pause 5000 pause 2000 fireEvent fireEvent(elementLocatore,evenName)模拟页面元素事件被激活的处理动作 fireEvent textField focus fireEvent dropDown blur waitForConditionwaitForCondition(JavaScriptSnippet,time)- 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待 waitForCondition var value=selenium.getText("foo"); value.match(/bar/); 3000 waitForValuewaitForValue(inputLocator, value) - 等待某input(如hidden input)被赋予某值， - 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞 waitForValue finishIndication isfinished store,stroreValuestore(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对话框出现时，也会同样地再次选择CancelanswerOnNextPrompt(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 assertValueassertValue(inputLocator, valuePattern) - 检查input的值- 对于 checkbox或radio，如果已选择，则值为”on”,反之为”off” verifyValue nameField John Smith assertValue document.forms[2].nameField John Smith assertSelected, assertSelectedOptionsassertSelected(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 assertTextassertText(elementLocator,textPattern)- 检查指定元素的文本- 只对有包含文本的元素生效- 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本 verifyText statusMessage Successful assertText //div[@id='foo']//h1 Successful assertTextPresent, assertAttributeassertTextPresent(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)assertTableassertTable(cellAddress, valuePattern) - 检查table里的某个cell中的值- cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始 verifyTable myTable.1.6 Submitted assertTable results0.2 13 assertVisible, nonVisibleassertVisible(elementLocator)- 检查指定的元素是否可视的 - 隐藏一个元素可以用设置css的‘visibility’属性为’hidden’，也可以设置‘display’属性为‘none’ verfyVisible postcode assertVisible postcode assertNotVisible(elementLocator) verfyNotVisible postcode assertNotVisible postcode Editable, non-editableassertEditable(inputLocator)检查指定的input是否可以编辑 verifyEditable shape assertEditable colour assertNotEditable(inputLocator)检查指定的input是否不可以编辑assertAlertassertAlert(messagePattern)- 检查JavaScript是否有产生带指定message的alert对话框- alert产生的顺序必须与检查的顺序一致- 检查alert时会产生与手动点击’OK’按钮一样的效果。如果一个alert产生了，而你却没有去检查它，selenium会在下个action中报错。- 注意：Selenium 不支持 JavaScript 在onload()事件时 调用alert();在这种情况下，Selenium需要你自己手动来点击OK.assertConfirmationassertConfirmation(messagePattern)- 检查JavaScript是否有产生带指定message的confirmation对话框和alert情况一样，confirmation对话框也必须在它们产生的时候进行检查-
默认情况下，Selenium会让confirm() 返回true,
相当于手动点击Ok按钮的效果。你能够通过chooseCancelOnNextConfirmation命令让confirm()返回false.同样
地，如果一个cofirmation对话框出现了，但你却没有检查的话，Selenium将会在下个action中报错- 注意：在Selenium的环境下，confirmation对话框框将不会再出现弹出显式对话框- 注意：Selenium不支持在onload()事件时调用confirmation对话框，在这种情况下，会出现显示confirmatioin对话框，并需要你自己手动点击。 assertPromptassertPrompt(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()) Title 命令(Command) 目标(Target) 值(Value) 命令(Command) 目标(Target) ( ) 判断(Assertion) 期望值(Expected) 实际值(Actual) |
|
|