Selenium IDE 的使用





http://www.tad0616.net/modules/tad_book3/page.php?tbdsn=827



Selenium API 中文手册refer from : http://www.tad0616.net/modules/tad_book3/page.php?tbdsn=826

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()｝

Labels: ,

沒有留言:

張貼留言

訂閱： 張貼留言 (Atom)