1、Selenium 中文手册Selenium, 手册, 中文 Selenium, 手册, 中文Selenium 中文手册一、 Commands (命令)Action对当前状态进行操作失败时，停止测试 Assertion校验是否有产生正确的值 Element Locators指定 HTML 中的某元素 Patterns用于模式匹配 1. Element Locators (元素定位器)id=idid locator 指定 HTML 中的唯一 id 的元素 name=namename locator 指定 HTML 中相同 name 的元素中的第一个元素 identifier=ididentifie
2、r locator 首先查找 HTML 是否存在该 id 的元素, 若不存在，查找第一个该 name 的元素 dom=javascriptExpressiondom locator 用 JavaScript 表达式来定位 HTML 中的元素,注意必须要以“document“开头例如:dom=document.formsmyForm.myDropdowndom=document.images56 xpath=xpathExpressionxpath locator 用 XPath 表达式来定位 HTML 中的元素,必须注意要以“/“开头例如：xpath=/imgalt=The image alt
3、 textxpath=/tableid=table1/tr4/td2 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 (字符串匹配模式)g
4、lob:patthernglob 模式，用通配符“*“代表任意长度字符，“?“代表一个字符 regexp:regexp正则表达式模式，用 JavaScript 正则表达式的形式匹配字符串 exact:string精确匹配模式，精确匹配整个字符串，不能用通配符 在没有指定字符串匹配前序的时候，selenium 默认使用 golb 匹配模式 3. Select Option Specifiers (Select 选项指定器)label=labelPattern通过匹配选项中的文本指定选项例如：label=regexp:Oother value=valuePattern通过匹配选项中的值指定选项例如
5、：value=other id=id通过匹配选项的 id 指定选项例如: id=option1 index=index通过匹配选项的序号指定选项，序号从 0 开始例如：index=2 在没有选项选择前序的情况下，默认是匹配选项的文本 二、 Actions描述了用户所会作出的操作。Action 有两种形式: action 和 actionAndWait, action 会立即执行，而actionAndWait 会假设需要较长时间才能得到该 action 的相响，而作出等待，open 则是会自动处理等待时间。clickclick(elementLocator)- 点击连接,按钮，复选和单选框- 如
6、果点击后需要等待响应，则用“clickAndWait“- 如果是需要经过 JavaScript 的 alert 或 confirm 对话框后才能继续操作，则需要调用 verify 或 assert 来告诉 Selenium 你期望对对话框进行什么操作。click aCheckbox clickAndWait submitButton clickAndWait anyLink openopen(url)- 在浏览器中打开 URL,可以接受相对和绝对路径两种形式- 注意：该 URL 必须在与浏览器相同的安全限定范围之内 open /mypage open http:/localhost/ type
7、type(inputLocator, value)- 模拟人手的输入过程，往指定的 input 中输入值- 也适合给复选和单选框赋值- 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本type nameField John Smith typeAndWait textBoxThatSubmitsOnChange newValue selectselect(dropDownLocator, optionSpecifier)- 根据 optionSpecifier 选项选择器来选择一个下拉菜单选项- 如果有多于一个选择器的时候，如在用通配符模式，如“f*b*“,或者超过一个选项有相
8、同的文本或值，则会选择第一个匹配到的值 select dropDown Australian Dollars select dropDown index=0 selectAndWait currencySelector value=AUD selectAndWait currencySelector label=Auslian D*rs goBack,closegoBack()模拟点击浏览器的后退按钮close()模拟点击浏览器关闭按钮 selectWindowselect(windowId)- 选择一个弹出窗口- 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行selectWindow
9、 myPopupWindow selectWindow null pausepause(millisenconds)- 根据指定时间暂停 Selenium 脚本执行- 常用在调试脚本或等待服务器段响应时 pause 5000 pause 2000 fireEventfireEvent(elementLocatore,evenName)模拟页面元素事件被激活的处理动作 fireEvent textField focus fireEvent dropDown blur waitForConditionwaitForCondition(JavaScriptSnippet,time)- 在限定时间内，
10、等待一段 JavaScript 代码返回 true 值，超时则停止等待waitForCondition var value=selenium.getText(“foo“); value.match(/bar/); 3000 waitForValuewaitForValue(inputLocator, value)- 等待某 input(如 hidden input)被赋予某值，- 会轮流检测该值，所以要注意如果该值长时间一直不赋予该 input 该值的话，可能会导致阻塞 waitForValue finishIndication isfinished store,stroreValuestor
11、e(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 $.use
12、rID storeText, storeAttributestoreText(elementLocator, variablename)把指定元素的文本值赋予给变量storeText currentDate expectedStartDate verifyValue startDate $.expectedStartDate storeAttribute(.elementLocatorattributeName,variableName.)把指定元素的属性的值赋予给变量storeAttribute input1class classOfInput1 verifyAttribute input2
13、class $.classOfInput1 chooseCancel, answerchooseCancelOnNextConfirmation()- 当下次 JavaScript 弹出 confirm 对话框的时候,让 selenium 选择 Cancel- 如果没有该命令时，遇到 confirm 对话框 Selenium 默认返回 true，如手动选择 OK 按钮一样 chooseCancelOnNextConfirmation - 如果已经运行过该命令，当下一次又有 confirm 对话框出现时，也会同样地再次选择 CancelanswerOnNextPrompt(answerStrin
14、g)- 在下次 JavaScript 弹出 prompt 提示框时，赋予其 anweerString 的值，并选择确定answerOnNextPrompt Kangaroo 三、 Assertions允许用户去检查当前状态。两种模式: Assert 和 Verify， 当 Assert 失败，则退出测试；当 Verify 失败，测试会继续运行。assertLocation, assertTitleassertLocation(relativeLocation)判断当前是在正确的页面 verifyLocation /mypage assertLocation /mypage assertTitl
15、e(titlePattern)检查当前页面的 title 是否正确 verifyTitle My Page assertTitle My Page assertValueassertValue(inputLocator, valuePattern)- 检查 input 的值- 对于 checkbox 或 radio，如果已选择，则值为“on“,反之为“off“ verifyValue nameField John Smith assertValue document.forms2.nameField John Smith assertSelected, assertSelectedOption
16、sassertSelected(selectLocator, optionSpecifier)检查 select 的下拉菜单中选中的选型是否和 optionSpecifer(Select 选择选项器)的选项相同 verifySelected dropdown2 John Smith verifySelected dorpdown2 value=js*123 assertSelected document.forms2.dropDown label=J*Smith assertSelected document.forms2.dropDown index=0 assertSelectOption
17、s(selectLocator, optionLabelList)- 检查下拉菜单中的选项的文本是否和 optionLabelList 相同- optionLabelList 是以逗号分割的一个字符串verifySelectOptions dropdown2 John Smith,Dave Bird assertSelectOptions document.forms2.dropdown Smith,J,Bird,D assertTextassertText(elementLocator,textPattern)- 检查指定元素的文本- 只对有包含文本的元素生效- 对于 Mozilla 类型的
18、浏览器，用 textContent 取元素的文本，对于 IE 类型的浏览器，用 innerText 取元素文本verifyText statusMessage Successful assertText /divid=foo/h1 Successful assertTextPresent, assertAttributeassertTextPresent(text)检查在当前给用户显示的页面上是否有出现指定的文本verifyTextPresent You are now logged in assertTextPresent You are now logged in assertAttrib
19、ute(.elementLocatorattributeName., ValuePattern)检查当前指定元素的属性的值 verifyAttribute txt1class bigAndBlod assertAttribute document.images0alt alt-text verifyAttribute /imgid=foo/alt alt-text assertTextPresent, etc.assertTextPresent(text)assertTextNotPresent(text)assertElementPresent(elementLocator) verifyE
20、lementPresent submitButton assertElementPresent /imgalt=foo assertElementNotPresent(elementLocator) assertTableassertTable(cellAddress, valuePattern)- 检查 table 里的某个 cell 中的值- cellAddress 的语法是 tableName.row.column, 注意行列序号都是从 0 开始verifyTable myTable.1.6 Submitted assertTable results0.2 13 assertVisibl
21、e, nonVisibleassertVisible(elementLocator)- 检查指定的元素是否可视的- 隐藏一个元素可以用设置 css 的visibility属性为hidden，也可以设置display属性为none verfyVisible postcode assertVisible postcode assertNotVisible(elementLocator) verfyNotVisible postcode assertNotVisible postcode Editable, non-editableassertEditable(inputLocator)检查指定的
22、input 是否可以编辑 verifyEditable shape assertEditable colour assertNotEditable(inputLocator)检查指定的 input 是否不可以编辑 assertAlertassertAlert(messagePattern)- 检查 JavaScript 是否有产生带指定 message 的 alert 对话框- alert 产生的顺序必须与检查的顺序一致- 检查 alert 时会产生与手动点击OK按钮一样的效果。如果一个 alert 产生了，而你却没有去检查它，selenium 会在下个 action 中报错。- 注意：Sel
23、enium 不支持 JavaScript 在 onload()事件时 调用 alert();在这种情况下，Selenium 需要你自己手动来点击 OK. assertConfirmationassertConfirmation(messagePattern)- 检查 JavaScript 是否有产生带指定 message 的 confirmation 对话框和alert 情况一样，confirmation 对话框也必须在它们产生的时候进行检查- 默认情况下，Selenium 会让 confirm() 返回 true, 相当于手动点击 Ok 按钮的效果。你能够通过 chooseCancelOnN
24、extConfirmation 命令让 confirm()返回false.同样 地，如果一个 cofirmation 对话框出现了，但你却没有检查的话，Selenium 将会在下个 action 中报错- 注意：在 Selenium 的环境下，confirmation 对话框框将不会再出现弹出显式对话框- 注意：Selenium 不支持在 onload()事件时调用 confirmation 对话框，在这种情况下，会出现显示 confirmatioin 对话框，并需要你自己手动点击。 assertPromptassertPrompt(messagePattern)- 检查 JavaScript
25、 是否有产生带指定 message 的 Prompt 对话框- 你检查的 prompt 的顺序 Prompt 对话框产生的顺序必须相同- 必须在 verifyPrompt 之前调用 answerOnNextPrompt 命令- 如果 prompt 对话框出现了但你却没有检查，则 Selenium 会在下个 action 中报错 answerOnNextPrompt Joe click id=delegate verifyPrompt Delegate to who? 四、 Parameters and Variables参数和变量的声明范围由简单的赋值到 JavaScript 表达式赋值。St
26、ore，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.storedVarsmerchantId.toUpperCase() Generating Unique values 产生唯一值. 问题：你需要唯一的用户名解决办法: 基于时间来产生用户名，如fred+(new Date().getTime()
