Tad 教材網 - 線上書籍

:::

2. XPath的使用【ZZ】

4. Selenium IDE的使用 next

Selenium
========

大家在編寫測試案例想查閱Selenium API說明時，可以查閱本文，否則請跳過！

(註：這裡API版本比較老，新版本的Selenium的API在這裡不一定能找到。)

Selenium API說明文檔
-----------------

(轉載自：[http://wiki.javascud.org/display/springs/SeleniumRefrence](http://www.cnblogs.com/cnblogsfans/archive/2008/12/23/1360320.html "http://www.cnblogs.com/cnblogsfans/archive/2008/12/23/1360320.html"))

###  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你期望對對話框進行什麼操作。 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> click</td> <td> aCheckbox</td> <td> </td> </tr> <tr> <td> clickAndWait</td> <td> submitButton</td> <td> </td> </tr> <tr> <td> clickAndWait</td> <td> anyLink</td> <td> </td> </tr> </tbody> </table>
- open  
   open(url)  
   - 在瀏覽器中打開URL,可以接受相對和絕對路徑兩種形式  
   - 注意：該URL必須在與瀏覽器相同的安全限定範圍之內 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> open</td> <td> /mypage</td> <td> </td> </tr> <tr> <td> open</td> <td> [http://localhost/![](http://images.cnblogs.com/icons/linkext7.gif)](http://localhost/ "Visit page outside Confluence")</td> <td> </td> </tr> </tbody> </table>
- type  
   type(inputLocator, value)  
   - 模擬人手的輸入過程，往指定的input中輸入值  
   - 也適合給複選和單選框賦值  
   - 在這個例子中，則只是給鉤選了的複選框賦值，注意，而不是改寫其文本 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> type</td> <td> nameField</td> <td> John Smith</td> </tr> <tr> <td> typeAndWait</td> <td> textBoxThatSubmitsOnChange</td> <td> newValue</td> </tr> </tbody> </table>
- select  
   select(dropDownLocator, optionSpecifier)  
   - 根據optionSpecifier選項選擇器來選擇一個下拉菜單選項  
   - 如果有多於一個選擇器的時候，如在用通配符模式，如"f\*b\*",或者超過一個選項有相同的文本或值，則會選擇第一個匹配到的值 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> select </td> <td> dropDown</td> <td> Australian Dollars</td> </tr> <tr> <td> select </td> <td> dropDown</td> <td> index=0</td> </tr> <tr> <td> selectAndWait</td> <td> currencySelector</td> <td> value=AUD</td> </tr> <tr> <td> selectAndWait</td> <td> currencySelector</td> <td> label=Auslian D\*rs</td> </tr> </tbody> </table>
- goBack,close  
   goBack()  
   模擬點擊瀏覽器的後退按鈕  
   close()  
   模擬點擊瀏覽器關閉按鈕
- selectWindow  
   select(windowId)  
   - 選擇一個彈出窗口  
   - 當選中那個窗口的時候，所有的命令將會轉移到那窗口中執行 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> selectWindow</td> <td> myPopupWindow</td> <td> </td> </tr> <tr> <td> selectWindow</td> <td> null</td> <td> </td> </tr> </tbody> </table>
- pause  
   pause(millisenconds)  
   - 根據指定時間暫停Selenium腳本執行  
   - 常用在調試腳本或等待服務器段響應時 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> pause</td> <td> 5000</td> <td> </td> </tr> <tr> <td> pause</td> <td> 2000</td> <td> </td> </tr> </tbody> </table>
- fireEvent  
   fireEvent(elementLocatore,evenName)  
   模擬頁面元素事件被激活的處理動作 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> fireEvent</td> <td> textField</td> <td> focus</td> </tr> <tr> <td> fireEvent</td> <td> dropDown</td> <td> blur</td> </tr> </tbody> </table>
- waitForCondition  
   waitForCondition(JavaScriptSnippet,time)  
   - 在限定時間內，等待一段JavaScript代碼返回true值，超時則停止等待 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> waitForCondition</td> <td> var value=selenium.getText("foo"); value.match(/bar/);</td> <td> 3000</td> </tr> </tbody> </table>
- waitForValue  
   waitForValue(inputLocator, value)  
   - 等待某input(如hidden input)被賦予某值，  
   - 會輪流檢測該值，所以要注意如果該值長時間一直不賦予該input該值的話，可能會導致阻塞 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> waitForValue</td> <td> finishIndication</td> <td> isfinished</td> </tr> <tr> <td> </td> <td> </td> <td> </td> </tr> </tbody> </table>
- store,stroreValue  
   store(valueToStore, variablename)  
   保存一個值到變量裡。  
   該值可以由自其他變量組合而成或通過JavaScript表達式賦值給變量 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> store</td> <td> Mr John Smith</td> <td> fullname</td> </tr> <tr> <td> store</td> <td> $.｛title｝ $.｛firstname｝ $.｛suname｝</td> <td> fullname</td> </tr> <tr> <td> store</td> <td> javascript.｛Math.round(Math.PI\*100)/100｝</td> <td> PI</td> </tr> <tr> <td> storeValue</td> <td> inputLocator</td> <td> variableName</td> </tr> </tbody> </table>
  
   把指定的input中的值保存到變量中
  
   <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> storeValue</td> <td> userName</td> <td> userID</td> </tr> <tr> <td> type</td> <td> userName</td> <td> $.｛userID｝</td> </tr> </tbody> </table>
- storeText, storeAttribute  
   storeText(elementLocator, variablename)  
   把指定元素的文本值賦予給變量 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> storeText</td> <td> currentDate</td> <td> expectedStartDate</td> </tr> <tr> <td> verifyValue</td> <td> startDate</td> <td> $.｛expectedStartDate｝</td> </tr> </tbody> </table>
  
   storeAttribute(.｛｝elementLocator@attributeName,variableName.｛｝)  
   把指定元素的屬性的值賦予給變量
  
   <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> storeAttribute</td> <td> input1@class </td> <td> classOfInput1</td> </tr> <tr> <td> verifyAttribute</td> <td> input2@class</td> <td> $.｛classOfInput1｝</td> </tr> </tbody> </table>
- chooseCancel.., answer..  
   chooseCancelOnNextConfirmation()  
   - 當下次JavaScript彈出confirm對話框的時候,讓selenium選擇Cancel  
   - 如果沒有該命令時，遇到confirm對話框Selenium默認返回true，如手動選擇OK按鈕一樣 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> chooseCancelOnNextConfirmation </td> <td> </td> <td> </td> </tr> </tbody> </table>
  
  \- 如果已經運行過該命令，當下一次又有confirm對話框出現時，也會同樣地再次選擇Cancel  
   answerOnNextPrompt(answerString)  
  \- 在下次JavaScript彈出prompt提示框時，賦予其anweerString的值，並選擇確定
  
   <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> answerOnNextPrompt</td> <td> Kangaroo</td> <td> </td> </tr> </tbody> </table>
 
###  Assertions

允許用戶去檢查當前狀態。兩種模式: Assert 和 Verify， 當Assert失敗，則退出測試；當Verify失敗，測試會繼續運行。

- assertLocation, assertTitle  
   assertLocation(relativeLocation)  
   判斷當前是在正確的頁面 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyLocation</td> <td> /mypage</td> <td> </td> </tr> <tr> <td> assertLocation</td> <td> /mypage</td> <td> </td> </tr> </tbody> </table>
- assertTitle(titlePattern)  
   檢查當前頁面的title是否正確 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyTitle</td> <td> My Page</td> <td> </td> </tr> <tr> <td> assertTitle</td> <td> My Page</td> <td> </td> </tr> </tbody> </table>
- assertValue  
   assertValue(inputLocator, valuePattern)  
   - 檢查input的值  
   - 對於 checkbox或radio，如果已選擇，則值為"on",反之為"off" <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyValue</td> <td> nameField</td> <td> John Smith</td> </tr> <tr> <td> assertValue</td> <td> document.forms\[2\].nameField</td> <td> John Smith</td> </tr> </tbody> </table>
- assertSelected, assertSelectedOptions  
   assertSelected(selectLocator, optionSpecifier)  
   檢查select的下拉菜單中選中的選型是否和optionSpecifer(Select選擇選項器)的選項相同 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifySelected</td> <td> dropdown2</td> <td> John Smith</td> </tr> <tr> <td> verifySelected</td> <td> dorpdown2</td> <td> value=js\*123</td> </tr> <tr> <td> assertSelected</td> <td> document.forms\[2\].dropDown</td> <td> label=J\*Smith</td> </tr> <tr> <td> assertSelected</td> <td> document.forms\[2\].dropDown</td> <td> index=0</td> </tr> </tbody> </table>
- assertSelectOptions(selectLocator, optionLabelList)  
   - 檢查下拉菜單中的選項的文本是否和optionLabelList相同  
   - optionLabelList是以逗號分割的一個字符串 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifySelectOptions</td> <td> dropdown2</td> <td> John Smith,Dave Bird</td> </tr> <tr> <td> assertSelectOptions</td> <td> document.forms\[2\].dropdown</td> <td> Smith,J,Bird,D</td> </tr> </tbody> </table>
- assertText  
   assertText(elementLocator,textPattern)  
   - 檢查指定元素的文本  
   - 只對有包含文本的元素生效  
   - 對於Mozilla類型的瀏覽器，用textContent取元素的文本，對於IE類型的瀏覽器，用innerText取元素文本 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyText</td> <td> statusMessage</td> <td> Successful</td> </tr> <tr> <td> assertText</td> <td> //div\[@id='foo'\]//h1</td> <td> Successful</td> </tr> </tbody> </table>
- assertTextPresent, assertAttribute  
   assertTextPresent(text)  
   檢查在當前給用戶顯示的頁面上是否有出現指定的文本 <table> <tbody> <tr> <td> verifyTextPresent</td> <td> You are now logged in</td> <td> </td> </tr> <tr> <td> assertTextPresent</td> <td> You are now logged in</td> <td> </td> </tr> </tbody> </table>
- assertAttribute(.｛｝elementLocator@attributeName.｛｝, ValuePattern)  
   檢查當前指定元素的屬性的值 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyAttribute</td> <td> txt1@class</td> <td> bigAndBlod</td> </tr> <tr> <td> assertAttribute</td> <td> document.images\[0\]@alt</td> <td> alt-text</td> </tr> <tr> <td> verifyAttribute</td> <td> //img\[@id='foo'\]/alt</td> <td> alt-text</td> </tr> </tbody> </table>
- assertTextPresent, etc.  
   assertTextPresent(text)  
   assertTextNotPresent(text)  
   assertElementPresent(elementLocator) <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyElementPresent</td> <td> submitButton</td> <td> </td> </tr> <tr> <td> assertElementPresent</td> <td> //img\[@alt='foo'\]</td> <td> </td> <td> assertElementNotPresent(elementLocator)</td> </tr> </tbody> </table>
- assertTable  
   assertTable(cellAddress, valuePattern)  
   - 檢查table裡的某個cell中的值  
   - cellAddress的語法是tableName.row.column, 注意行列序號都是從0開始 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyTable</td> <td> myTable.1.6</td> <td> Submitted</td> </tr> <tr> <td> assertTable</td> <td> results0.2</td> <td> 13</td> </tr> </tbody> </table>
- assertVisible, nonVisible  
   assertVisible(elementLocator)  
   - 檢查指定的元素是否可視的  
   - 隱藏一個元素可以用設置css的'visibility'屬性為'hidden'，也可以設置'display'屬性為'none' <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verfyVisible</td> <td> postcode</td> <td> </td> </tr> <tr> <td> assertVisible</td> <td> postcode</td> <td> </td> </tr> </tbody> </table>
- assertNotVisible(elementLocator) <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verfyNotVisible</td> <td> postcode</td> <td> </td> </tr> <tr> <td> assertNotVisible</td> <td> postcode</td> <td> </td> </tr> </tbody> </table>
- Editable, non-editable  
   assertEditable(inputLocator)  
   檢查指定的input是否可以編輯 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> verifyEditable</td> <td> shape</td> <td> </td> </tr> <tr> <td> assertEditable</td> <td> colour</td> <td> </td> </tr> </tbody> </table>
- 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中報錯 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> answerOnNextPrompt</td> <td> Joe</td> <td> </td> </tr> <tr> <td> click</td> <td> id=delegate</td> <td> </td> </tr> <tr> <td> verifyPrompt</td> <td> Delegate to who?</td> <td> </td> </tr> </tbody> </table>
 
###  Parameters and Variables

參數和變量的聲明範圍由簡單的賦值到JavaScript表達式賦值。  
 Store，storeValue 和storeText 為下次訪問保存值。  
 在Selenium內部是用一個叫storeVars的map來保存變量名。

- Variable Substitution 變量替換  
   提供了一個簡單的方法去訪問變量,語法 $.｛xxx｝ <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> store</td> <td> Mr</td> <td> title</td> </tr> <tr> <td> storeValue</td> <td> nameField</td> <td> surname</td> </tr> <tr> <td> store</td> <td> $.｛title｝ $.｛suname｝</td> <td> fullname</td> </tr> <tr> <td> type</td> <td> textElement</td> <td> Full name is: $.｛fullname｝</td> </tr> </tbody> </table>
- JavaScript Evaluation JavaScript賦值  
   你能用JavaScript來構建任何你所需要的值。  
   這個參數是以javascript開頭，語法是 javascript.｛'with a trailing'｝。  
   可以通過JavaScript表達式給某元素賦值。 <table cellpadding="0" cellspacing="0"> <tbody> <tr> <td> store</td> <td> javascript.｛'merchant'+(new Date()).getTime()｝</td> <td> merchantId</td> </tr> <tr> <td> type</td> <td> textElement</td> <td> javascript.｛storedVars\['merchantId'\].toUpperCase()｝</td> </tr> </tbody> </table>

:::