Selenium API參考手冊(cè)
Commands (命令)
Action
對(duì)當(dāng)前狀態(tài)進(jìn)行操作
失敗時(shí)，停止測(cè)試
Assertion
校驗(yàn)是否有產(chǎn)生正確的值
Element Locators
指定HTML中的某元素
Patterns
用于模式匹配
1. Element Locators (元素定位器)
id=id
id locator 指定HTML中的id的元素
name=name
name locator指定 HTML中相同name的元素中的第一個(gè)元素
identifier=id
identifier locator 首先查找HTML是否存在該id的元素， 若不存在，查找第一個(gè)該name的元素
dom=javascriptExpression
dom locator用JavaScript表達(dá)式來定位HTML中的元素，注意必須要以"document"開頭
例如:
dom=document.forms['myForm'].myDropdown
dom=document.images[56]
xpath=xpathExpression
xpath locator用 XPath 表達(dá)式來定位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
在沒有l(wèi)ocator前序的情況下 Without a locator prefix， Selenium uses:
如果以"document."開頭，則默認(rèn)是使用 dom locator，如果是以"//"開頭，則默認(rèn)使用xpath locator，其余情況均認(rèn)作identifier locator
2. String Matching Patterns (字符串匹配模式)
glob:patthern
glob模式，用通配符"*"代表任意長(zhǎng)度字符，"?"代表一個(gè)字符
regexp:regexp
正則表達(dá)式模式，用JavaScript正則表達(dá)式的形式匹配字符串
exact:string
精確匹配模式，精確匹配整個(gè)字符串，不能用通配符
在沒有指定字符串匹配前序的時(shí)候，selenium 默認(rèn)使用golb 匹配模式
3. Select Option Specifiers (Select選項(xiàng)指定器)
label=labelPattern
通過匹配選項(xiàng)中的文本指定選項(xiàng)
例如：label=regexp:^[Oo]ther
value=valuePattern
通過匹配選項(xiàng)中的值指定選項(xiàng)
例如：value=other
id=id
通過匹配選項(xiàng)的id指定選項(xiàng)
例如: id=option1
index=index
通過匹配選項(xiàng)的序號(hào)指定選項(xiàng)，序號(hào)從0開始
例如：index=2
在沒有選項(xiàng)選擇前序的情況下，默認(rèn)是匹配選項(xiàng)的文本
Actions
描述了用戶所會(huì)作出的操作。
Action 有兩種形式: action和actionAndWait， action會(huì)立即執(zhí)行，而actionAndWait會(huì)假設(shè)需要較長(zhǎng)時(shí)間才能得到該action的相響，而作出等待，open則是會(huì)自動(dòng)處理等待時(shí)間。
click
click(elementLocator)
- 點(diǎn)擊連接，按鈕，復(fù)選和單選框
- 如果點(diǎn)擊后需要等待響應(yīng)，則用"clickAndWait"
- 如果是需要經(jīng)過JavaScript的alert或confirm對(duì)話框后才能繼續(xù)操作，則需要調(diào)用verify或assert來告訴Selenium你期望對(duì)對(duì)話框進(jìn)行什么操作。
click aCheckbox
clickAndWait submitButton
clickAndWait anyLink
open
open(url)
- 在瀏覽器中打開URL，可以接受相對(duì)和路徑兩種形式
- 注意：該URL必須在與瀏覽器相同的安全限定范圍之內(nèi)
open /mypage
open http://localhost/
type
type(inputLocator， value)
- 模擬人手的輸入過程，往指定的input中輸入值
- 也適合給復(fù)選和單選框賦值
- 在這個(gè)例子中，則只是給鉤選了的復(fù)選框賦值，注意，而不是改寫其文本
type nameField John Smith
typeAndWait textBoxThatSubmitsOnChange newValue
select
select(dropDownLocator， optionSpecifier)
- 根據(jù)optionSpecifier選項(xiàng)選擇器來選擇一個(gè)下拉菜單選項(xiàng)
- 如果有多于一個(gè)選擇器的時(shí)候，如在用通配符模式，如"f*b*"，或者超過一個(gè)選項(xiàng)有相同的文本或值，則會(huì)選擇第一個(gè)匹配到的值
select dropDown Australian Dollars
select dropDown index=0
selectAndWait currencySelector value=AUD
selectAndWait currencySelector label=Auslian D*rs
goBack，close
goBack()
模擬點(diǎn)擊瀏覽器的后退按鈕
close()
模擬點(diǎn)擊瀏覽器關(guān)閉按鈕
selectWindow
select(windowId)
- 選擇一個(gè)彈出窗口
- 當(dāng)選中那個(gè)窗口的時(shí)候，所有的命令將會(huì)轉(zhuǎn)移到那窗口中執(zhí)行
selectWindow myPopupWindow
selectWindow null
pause
pause(millisenconds)
- 根據(jù)指定時(shí)間暫停Selenium腳本執(zhí)行
- 常用在調(diào)試腳本或等待服務(wù)器段響應(yīng)時(shí)
pause 5000
pause 2000
fireEvent
fireEvent(elementLocatore，evenName)
模擬頁面元素事件被激活的處理動(dòng)作
fireEvent textField focus
fireEvent dropDown blur
waitForCondition
waitForCondition(JavaScriptSnippet，time)
- 在限定時(shí)間內(nèi)，等待一段JavaScript代碼返回true值，超時(shí)則停止等待
waitForCondition var value=selenium.getText("foo"); value.match(/bar/); 3000
waitForValue
waitForValue(inputLocator， value)
- 等待某input(如hidden input)被賦予某值，
- 會(huì)輪流檢測(cè)該值，所以要注意如果該值長(zhǎng)時(shí)間一直不賦予該input該值的話，可能會(huì)導(dǎo)致阻塞
waitForValue finishIndication isfinished
store，stroreValue
store(valueToStore， variablename)
保存一個(gè)值到變量里。
該值可以由自其他變量組合而成或通過JavaScript表達(dá)式賦值給變量
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｝
