Selenium中文手册 - 其他工具与自动化测试框架 - 51Testing软件 自动化测试框架

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你期望对对话框进行什么操作。clickaCheckbox

clickAndWaitsubmitButton

clickAndWaitanyLink

open

open(url)

- 在浏览器中打开URL,可以接受相对和绝对路径两种形式

- 注意:该URL必须在与浏览器相同的安全限定范围之内open/mypage

openhttp://localhost/

type

type(inputLocator, value)

- 模拟人手的输入过程,往指定的input中输入值

- 也适合给复选和单选框赋值

- 在这个例子中,则只是给钩选了的复选框赋值,注意,而不是改写其文本typenameFieldJohn Smith
Selenium中文手册 - [其他工具与自动化测试框架] - 51Testing软件 自动化测试框架

typeAndWaittextBoxThatSubmitsOnChangenewValue

select

select(dropDownLocator, optionSpecifier)

- 根据optionSpecifier选项选择器来选择一个下拉菜单选项

- 如果有多于一个选择器的时候,如在用通配符模式,如"f*b*",或者超过一个选项有相同的文本或值,则会选择第一个匹配到的值select dropDownAustralian Dollars

select dropDownindex=0

selectAndWaitcurrencySelectorvalue=AUD

selectAndWaitcurrencySelectorlabel=Auslian D*rs

goBack,close

goBack()

模拟点击浏览器的后退按钮

close()

模拟点击浏览器关闭按钮

selectWindow

select(windowId)

- 选择一个弹出窗口

- 当选中那个窗口的时候,所有的命令将会转移到那窗口中执行selectWindowmyPopupWindow

selectWindownull

pause

pause(millisenconds)

- 根据指定时间暂停Selenium脚本执行

- 常用在调试脚本或等待服务器段响应时pause5000

pause2000

fireEvent

fireEvent(elementLocatore,evenName)

模拟页面元素事件被激活的处理动作fireEventtextFieldfocus

fireEventdropDownblur

waitForCondition

waitForCondition(JavaScriptSnippet,time)

- 在限定时间内,等待一段JavaScript代码返回true值,超时则停止等待waitForConditionvar value=selenium.getText("foo"); value.match(/bar/);3000

waitForValue

waitForValue(inputLocator, value)

- 等待某input(如hidden input)被赋予某值,

- 会轮流检测该值,所以要注意如果该值长时间一直不赋予该input该值的话,可能会导致阻塞waitForValuefinishIndicationisfinished

store,stroreValue

store(valueToStore, variablename)

保存一个值到变量里。

该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量storeMr John Smithfullname

store$.{title} $.{firstname} $.{suname}fullname

storejavascript.{Math.round(Math.PI*100)/100}PI

storeValueinputLocatorvariableName

把指定的input中的值保存到变量中

storeValueuserNameuserID

typeuserName$.{userID}

storeText, storeAttribute

storeText(elementLocator, variablename)

把指定元素的文本值赋予给变量storeTextcurrentDateexpectedStartDate

verifyValuestartDate$.{expectedStartDate}

storeAttribute(.{}elementLocator@attributeName,variableName.{})

把指定元素的属性的值赋予给变量

storeAttributeinput1@class classOfInput1

verifyAttributeinput2@class$.{classOfInput1}

chooseCancel.., answer..

chooseCancelOnNextConfirmation()

- 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel

- 如果没有该命令时,遇到confirm对话框Selenium默认返回true,如手动选择OK按钮一样chooseCancelOnNextConfirmation

- 如果已经运行过该命令,当下一次又有confirm对话框出现时,也会同样地再次选择Cancel

answerOnNextPrompt(answerString)

- 在下次JavaScript弹出prompt提示框时,赋予其anweerString的值,并选择确定

answerOnNextPromptKangaroo

三、 Assertions

允许用户去检查当前状态。两种模式: Assert 和 Verify, 当Assert失败,则退出测试;当Verify失败,测试会继续运行。

assertLocation, assertTitle

assertLocation(relativeLocation)

判断当前是在正确的页面verifyLocation/mypage

assertLocation/mypage

assertTitle(titlePattern)

检查当前页面的title是否正确verifyTitleMy Page

assertTitleMy Page

assertValue

assertValue(inputLocator, valuePattern)

- 检查input的值

- 对于 checkbox或radio,如果已选择,则值为"on",反之为"off"verifyValuenameFieldJohn Smith

assertValuedocument.forms[2].nameFieldJohn Smith

assertSelected, assertSelectedOptions

assertSelected(selectLocator, optionSpecifier)

检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同verifySelecteddropdown2John Smith

verifySelecteddorpdown2value=js*123

assertSelecteddocument.forms[2].dropDownlabel=J*Smith

assertSelecteddocument.forms[2].dropDownindex=0

assertSelectOptions(selectLocator, optionLabelList)

- 检查下拉菜单中的选项的文本是否和optionLabelList相同

- optionLabelList是以逗号分割的一个字符串verifySelectOptionsdropdown2John Smith,Dave Bird

assertSelectOptionsdocument.forms[2].dropdownSmith,J,Bird,D

assertText

assertText(elementLocator,textPattern)

- 检查指定元素的文本

- 只对有包含文本的元素生效

- 对于Mozilla类型的浏览器,用textContent取元素的文本,对于IE类型的浏览器,用innerText取元素文本verifyTextstatusMessageSuccessful

assertText//div[@id='foo']//h1Successful

assertTextPresent, assertAttribute

assertTextPresent(text)

检查在当前给用户显示的页面上是否有出现指定的文本verifyTextPresentYou are now logged in

assertTextPresentYou are now logged in

assertAttribute(.{}elementLocator@attributeName.{}, ValuePattern)

检查当前指定元素的属性的值verifyAttributetxt1@classbigAndBlod

assertAttributedocument.images[0]@altalt-text

verifyAttribute//img[@id='foo']/altalt-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开始verifyTablemyTable.1.6Submitted

assertTableresults0.213

assertVisible, nonVisible

assertVisible(elementLocator)

- 检查指定的元素是否可视的

- 隐藏一个元素可以用设置css的'visibility'属性为'hidden',也可以设置'display'属性为'none'verfyVisiblepostcode

assertVisiblepostcode

assertNotVisible(elementLocator) verfyNotVisible postcode

assertNotVisible postcode

Editable, non-editable

assertEditable(inputLocator)

检查指定的input是否可以编辑verifyEditableshape

assertEditablecolour

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中报错answerOnNextPromptJoe

clickid=delegate

verifyPromptDelegate to who?

四、 Parameters and Variables

参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。

Store,storeValue 和storeText 为下次访问保存值。

在Selenium内部是用一个叫storeVars的map来保存变量名。

Variable Substitution 变量替换

提供了一个简单的方法去访问变量,语法 $.{xxx}storeMrtitle

storeValuenameFieldsurname

store$.{title} $.{suname}fullname

typetextElementFull name is: $.{fullname}

JavaScript Evaluation JavaScript赋值

你能用JavaScript来构建任何你所需要的值。

这个参数是以javascript开头,语法是 javascript.{'with a trailing'}。

可以通过JavaScript表达式给某元素赋值。storejavascript.{'merchant'+(new Date()).getTime()}merchantId

typetextElementjavascript.{storedVars['merchantId'].toUpperCase()}

Generating Unique values 产生唯一值.

问题:你需要唯一的用户名

解决办法: 基于时间来产生用户名,如'fred'+(new Date().getTime())

  

爱华网本文地址 » http://www.413yy.cn/a/25101012/125224.html

更多阅读

过程控制与自动化仪表考题和复习资料

过程控制与自动化仪表考题和复习资料一填空题1过程控制系统按设定值不同可以分为定值控制系统、随动控制系统、顺序控制系统。2Ⅲ型电动单元组合仪表的电压信号标准是1-5VDC电流信号标准是4-20mADC,气动仪表输入输出模拟信号统一

声明:《Selenium中文手册 - 其他工具与自动化测试框架 - 51Testing软件 自动化测试框架》为网友凯源有玺分享!如侵犯到您的合法权益请联系我们删除