Selenium私房菜系列3 -- Selenium API参考手册
2014-03-12 15:53
330 查看
大家在编写测试案例想查阅Selenium API说明时，可以查阅本文，否则请跳过！
(注：这里API版本比较老，新版本的Selenium的API在这里不一定能找到。)
Selenium API说明文档(转载自：http://wiki.javascud.org/display/springs/SeleniumRefrence)
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
在没有选项选择前序的情况下，默认是匹配选项的文本
描述了用户所会作出的操作。
Action 有两种形式: action和actionAndWait, action会立即执行，而actionAndWait会假设需要较长时间才能得到该action的相响，而作出等待，open则是会自动处理等待时间。
click
click(elementLocator)
- 点击连接,按钮，复选和单选框
- 如果点击后需要等待响应，则用"clickAndWait"
- 如果是需要经过JavaScript的alert或confirm对话框后才能继续操作，则需要调用verify或assert来告诉Selenium你期望对对话框进行什么操作。
open
open(url)
- 在浏览器中打开URL,可以接受相对和绝对路径两种形式
- 注意：该URL必须在与浏览器相同的安全限定范围之内
type
type(inputLocator, value)
- 模拟人手的输入过程，往指定的input中输入值
- 也适合给复选和单选框赋值
- 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本
select
select(dropDownLocator, optionSpecifier)
- 根据optionSpecifier选项选择器来选择一个下拉菜单选项
- 如果有多于一个选择器的时候，如在用通配符模式，如"f*b*",或者超过一个选项有相同的文本或值，则会选择第一个匹配到的值
goBack,close
goBack()
模拟点击浏览器的后退按钮
close()
模拟点击浏览器关闭按钮
selectWindow
select(windowId)
- 选择一个弹出窗口
- 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行
pause
pause(millisenconds)
- 根据指定时间暂停Selenium脚本执行
- 常用在调试脚本或等待服务器段响应时
fireEvent
fireEvent(elementLocatore,evenName)
模拟页面元素事件被激活的处理动作
waitForCondition
waitForCondition(JavaScriptSnippet,time)
- 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待
waitForValue
waitForValue(inputLocator, value)
- 等待某input(如hidden input)被赋予某值，
- 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞
store,stroreValue
store(valueToStore, variablename)
保存一个值到变量里。
该值可以由自其他变量组合而成或通过JavaScript表达式赋值给变量
把指定的input中的值保存到变量中
storeText, storeAttribute
storeText(elementLocator, variablename)
把指定元素的文本值赋予给变量
storeAttribute(.｛｝elementLocator@attributeName,variableName.｛｝)
把指定元素的属性的值赋予给变量
chooseCancel.., answer..
chooseCancelOnNextConfirmation()
- 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
- 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样
- 如果已经运行过该命令，当下一次又有confirm对话框出现时，也会同样地再次选择Cancel
answerOnNextPrompt(answerString)
- 在下次JavaScript弹出prompt提示框时，赋予其anweerString的值，并选择确定
允许用户去检查当前状态。两种模式: Assert 和 Verify， 当Assert失败，则退出测试；当Verify失败，测试会继续运行。
assertLocation, assertTitle
assertLocation(relativeLocation)
判断当前是在正确的页面
assertTitle(titlePattern)
检查当前页面的title是否正确
assertValue
assertValue(inputLocator, valuePattern)
- 检查input的值
- 对于 checkbox或radio，如果已选择，则值为"on",反之为"off"
assertSelected, assertSelectedOptions
assertSelected(selectLocator, optionSpecifier)
检查select的下拉菜单中选中的选型是否和optionSpecifer(Select选择选项器)的选项相同
assertSelectOptions(selectLocator, optionLabelList)
- 检查下拉菜单中的选项的文本是否和optionLabelList相同
- optionLabelList是以逗号分割的一个字符串
assertText
assertText(elementLocator,textPattern)
- 检查指定元素的文本
- 只对有包含文本的元素生效
- 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本
assertTextPresent, assertAttribute
assertTextPresent(text)
检查在当前给用户显示的页面上是否有出现指定的文本
assertAttribute(.｛｝elementLocator@attributeName.｛｝,
ValuePattern)
检查当前指定元素的属性的值
assertTextPresent, etc.
assertTextPresent(text)
assertTextNotPresent(text)
assertElementPresent(elementLocator)
assertTable
assertTable(cellAddress, valuePattern)
- 检查table里的某个cell中的值
- cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始
assertVisible, nonVisible
assertVisible(elementLocator)
- 检查指定的元素是否可视的
- 隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none'
assertNotVisible(elementLocator)
Editable, non-editable
assertEditable(inputLocator)
检查指定的input是否可以编辑
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中报错
参数和变量的声明范围由简单的赋值到JavaScript表达式赋值。
Store，storeValue 和storeText 为下次访问保存值。
在Selenium内部是用一个叫storeVars的map来保存变量名。
Variable Substitution 变量替换
提供了一个简单的方法去访问变量,语法 $.｛xxx｝
JavaScript Evaluation JavaScript赋值
你能用JavaScript来构建任何你所需要的值。
这个参数是以javascript开头，语法是 javascript.｛'with a trailing'｝。
可以通过JavaScript表达式给某元素赋值。
转自：http://www.cnblogs.com/hyddd/archive/2009/05/22/1487346.html
(注：这里API版本比较老，新版本的Selenium的API在这里不一定能找到。)
Selenium API说明文档(转载自：http://wiki.javascud.org/display/springs/SeleniumRefrence)
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(url)
- 在浏览器中打开URL,可以接受相对和绝对路径两种形式
- 注意：该URL必须在与浏览器相同的安全限定范围之内
| open | /mypage | |
| open | http://localhost/ |
type(inputLocator, value)
- 模拟人手的输入过程，往指定的input中输入值
- 也适合给复选和单选框赋值
- 在这个例子中，则只是给钩选了的复选框赋值，注意，而不是改写其文本
| type | nameField | John Smith |
| typeAndWait | textBoxThatSubmitsOnChange | newValue |
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()
模拟点击浏览器关闭按钮
selectWindow
select(windowId)
- 选择一个弹出窗口
- 当选中那个窗口的时候，所有的命令将会转移到那窗口中执行
| selectWindow | myPopupWindow | |
| selectWindow | null |
pause(millisenconds)
- 根据指定时间暂停Selenium脚本执行
- 常用在调试脚本或等待服务器段响应时
| pause | 5000 | |
| pause | 2000 |
fireEvent(elementLocatore,evenName)
模拟页面元素事件被激活的处理动作
| fireEvent | textField | focus |
| fireEvent | dropDown | blur |
waitForCondition(JavaScriptSnippet,time)
- 在限定时间内，等待一段JavaScript代码返回true值，超时则停止等待
| waitForCondition | var value=selenium.getText("foo"); value.match(/bar/); | 3000 |
waitForValue(inputLocator, value)
- 等待某input(如hidden input)被赋予某值，
- 会轮流检测该值，所以要注意如果该值长时间一直不赋予该input该值的话，可能会导致阻塞
| waitForValue | finishIndication | isfinished |
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 |
| storeValue | userName | userID |
| type | userName | $.｛userID｝ |
storeText(elementLocator, variablename)
把指定元素的文本值赋予给变量
| storeText | currentDate | expectedStartDate |
| verifyValue | startDate | $.｛expectedStartDate｝ |
把指定元素的属性的值赋予给变量
| storeAttribute | input1@class | classOfInput1 |
| verifyAttribute | input2@class | $.｛classOfInput1｝ |
chooseCancelOnNextConfirmation()
- 当下次JavaScript弹出confirm对话框的时候,让selenium选择Cancel
- 如果没有该命令时，遇到confirm对话框Selenium默认返回true，如手动选择OK按钮一样
| chooseCancelOnNextConfirmation |
answerOnNextPrompt(answerString)
- 在下次JavaScript弹出prompt提示框时，赋予其anweerString的值，并选择确定
| answerOnNextPrompt | Kangaroo |
Assertions
允许用户去检查当前状态。两种模式: Assert 和 Verify， 当Assert失败，则退出测试；当Verify失败，测试会继续运行。assertLocation, assertTitle
assertLocation(relativeLocation)
判断当前是在正确的页面
| verifyLocation | /mypage | |
| assertLocation | /mypage |
检查当前页面的title是否正确
| verifyTitle | My Page | |
| assertTitle | My Page |
assertValue(inputLocator, valuePattern)
- 检查input的值
- 对于 checkbox或radio，如果已选择，则值为"on",反之为"off"
| verifyValue | nameField | John Smith |
| assertValue | document.forms[2].nameField | John Smith |
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 |
- 检查下拉菜单中的选项的文本是否和optionLabelList相同
- optionLabelList是以逗号分割的一个字符串
| verifySelectOptions | dropdown2 | John Smith,Dave Bird |
| assertSelectOptions | document.forms[2].dropdown | Smith,J,Bird,D |
assertText(elementLocator,textPattern)
- 检查指定元素的文本
- 只对有包含文本的元素生效
- 对于Mozilla类型的浏览器，用textContent取元素的文本，对于IE类型的浏览器，用innerText取元素文本
| verifyText | statusMessage | Successful |
| assertText | //div[@id='foo']//h1 | Successful |
assertTextPresent(text)
检查在当前给用户显示的页面上是否有出现指定的文本
| verifyTextPresent | You are now logged in | |
| assertTextPresent | You are now logged in |
ValuePattern)
检查当前指定元素的属性的值
| verifyAttribute | txt1@class | bigAndBlod |
| assertAttribute | document.images[0]@alt | alt-text |
| verifyAttribute | //img[@id='foo']/alt | alt-text |
assertTextPresent(text)
assertTextNotPresent(text)
assertElementPresent(elementLocator)
| verifyElementPresent | submitButton | ||
| assertElementPresent | //img[@alt='foo'] | assertElementNotPresent(elementLocator) |
assertTable(cellAddress, valuePattern)
- 检查table里的某个cell中的值
- cellAddress的语法是tableName.row.column, 注意行列序号都是从0开始
| verifyTable | myTable.1.6 | Submitted |
| assertTable | results0.2 | 13 |
assertVisible(elementLocator)
- 检查指定的元素是否可视的
- 隐藏一个元素可以用设置css的'visibility'属性为'hidden'，也可以设置'display'属性为'none'
| verfyVisible | postcode | |
| assertVisible | postcode |
| verfyNotVisible | postcode | |
| assertNotVisible | postcode |
assertEditable(inputLocator)
检查指定的input是否可以编辑
| verifyEditable | shape | |
| assertEditable | colour |
检查指定的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来构建任何你所需要的值。
这个参数是以javascript开头，语法是 javascript.｛'with a trailing'｝。
可以通过JavaScript表达式给某元素赋值。
| store | javascript.｛'merchant'+(new Date()).getTime()｝ | merchantId |
| type | textElement | javascript.｛storedVars['merchantId'].toUpperCase()｝ |
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Selenium私房菜系列3-- Selenium API参考手册
- Selenium私房菜系列3 -- Selenium API参考手册
- Selenium私房菜系列3 -- Selenium API参考手册【ZZ】
- Selenium私房菜系列3 -- Selenium API参考手册【ZZ】
- Selenium私房菜系列3 -- Selenium API参考手册【ZZ】
- Selenium私房菜系列3 -- Selenium API参考手册
- Selenium私房菜系列3 -- Selenium API参考手册【ZZ】
- Selenium私房菜系列1 -- Selenium简介
- Video for Linux 2.0 版API参考手册
- Selenium私房菜系列9 -- Selenium RC服务器命令行参数列表【ZZ】
- [SQL Relay文档] SQL Relay中PHP API参考手册 (英文)
- Selenium私房菜系列10 -- 我遇到的问题及解决问题的方法
- Selenium私房菜系列4 -- Selenium IDE的使用
- Dubbo -- 系统学习 笔记 -- API参考手册
- [SQL Relay文档] SQL Relay中PHP API参考手册 (英文)
- Video for Linux 2.0 版API参考手册
- Selenium私房菜系列2-- XPath的使用
- 【Selenium】私房菜系列汇总
- quick-cocos2d-x API 以及 参考手册
- ucos II API参考手册