Selenium API參考手冊
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｝
