Selenium 中文API文檔

標籤：

轉自：http://blog.csdn.net/lh9529/article/details/3946567

概念

Selenium 經過命令進行驅動。Selenium 可概括爲三種「風格」：動做、輔助和斷言。每個命令調用就是下表中的一行。

命令

目標

值

動做(Actions)命令通常用於操做應用程序的狀態。它們經過如」點擊連接」和」選擇選項」的方式進行工做。若是一個動做執行失敗，或是有錯誤，當前的測試將會中止執行。

許多動做能夠被包含後綴」並等待」的方式進行調用，例如,」點擊並等待」。這個後綴告知Selenium，該命令將使瀏覽器向服務器產生一個請求，並使得Selenium等待加載一個新的頁面。

輔助(Accessors)用於檢查應用程序的狀態並將結果存儲在變量中。例如」storeTitle」。它們一樣可用於自動生成斷言。

斷言(Assertions)相似於輔助，但它們能夠驗證應用程序的狀態是否同所指望的相一致。例如包括」確認頁面標題爲X」和」驗證該複選框是否被勾選」。

全部的Selenium斷言能夠被用於三種模式：」assert」, 「verify」，和」waitfor」。例如，你能夠」assertText」，」verifyText」，及」waitforText」。當」assert」失敗時，該測試將終止。當」verify」失敗時，該測試將繼續執行，並將錯誤記入日誌。這就容許了經過單條」assert」確保應用程序在正確的頁面上，而經過一系列的」verify」斷言測試表單上的區域值，標籤等。

「waitfor」命令用於等待某些條件變爲真(可用於Ajax應用程序的測試)。若是該條件已經爲真，他們將當即成功執行。反之，若是該條件不爲真，則將失敗並暫停測試，直到超過當前所設定的超時時間(參照後面的setTimeout動做)。

元素定位器(Element Locators)告訴Selenium是向HTML中的哪個元素髮送命令。許多命令須要一個如」target」屬性的元素定位器。這其中包括」elementId」和」document. forms[0].element」。在接下來的部分將更詳細的描述它們。

式樣(Patterns)因爲多種因素被使用着，如指定一個輸入域的指望值，或識別一個選擇選項。Selenium支持許多類型的式樣，其中包括正則表達式，全部這些將在接下來的章節中進行更詳細的描述。

定義一個類用於運行Selenium命令。

元素定位器(Element Locators)

元素定位器(Element Locators)告訴Selenium是向HTML中的哪個元素髮送命令。一個定位器的格式以下：

       locatorType = argument

咱們支持以下寫法用於定位元素：

·identifier=id :根據指定的@id屬性選擇元素。若是沒有匹配的值，則選擇第一個@name屬性爲id的元素。(參照後面)

·id=id :根據指定的@id屬性選擇元素。

·name=name :選擇第一個根據指定的@name所查找到的元素。

    〇　username

    〇  name=username

這裏的name能夠做爲可選項跟在一個或多個元素過濾器的後面，經過空格進行分隔。若是沒有指定過濾類型，則假定爲value。

    〇  name=flavour value=chocolate

·dom=javascriptExpression: 經過檢測指定字符串查找元素。這使得你能夠經過 JavaScript貫穿HTML文檔對象。注意在這個字符串中返回值不是必須的；僅僅只須要確保這條語句是你塊中的最後一條。

    〇  dom=document.forms[´myForm´].myDropdown

       〇  dom=document.images[56]

       〇  dom=function foo() { return document.links[1];}; foo();

·xpath=xpathExpression: 經過XPath 表達式定位元素。

    〇  xpath=//img[@alt=´The image alt text´]

    〇  xpath=//table[@id=´table1´]//tr[4]/td[2]

    〇  xpath=//a[contains(@href, ´#id1´)]

    〇  xpath=//a[contains(@href, ´#id1´)]/@class

    〇  xpath=(//table[@class=´stylee´])//th[text()=´theHeaderText´]/../td

    〇  xpath=//input[@name=´name2´ and @value=´yes´]

    〇  xpath=//*[text()=″right″]

·link=textPattern: 選擇所包含的文字匹配指定式樣的連接(錨)。

    〇  link=The link text

·css=cssSelectorSyntax: 經過css選擇器選擇元素。請查詢CSS2 選擇器，CSS3 選擇器以得到更多信息。在下載下來的selenium core package中的selenium test suite 裏的TestCssLocators test ,你一樣能夠查看到使用例子。

    〇  css=a[href=″#id3″]

       〇  css=span#firstChid + span

當前css選擇過濾器支持全部的css1,css2,css3,除了css3中一些虛擬類(:nth-of-type,:nth-last-of-type,:first-of-type,:last-of-type,:only-of-type,:visited,:hover,:active,:focus,:indeterminate)以及虛擬元素(::first-line,::first-letter,::selection,::before,::after)。

若是沒有一個顯式的前綴，Selenium使用如下默認寫法：

·dom,用於開頭爲″document.″的定位器

·xpath,用於開頭爲″//″的定位器

·identifier，其餘

元素過濾器(Element Filters)

 

元素過濾器能夠同選擇器一塊兒使用，從一堆候選元素中進行篩選。它們當前僅使用於’name’元素選擇器。

過濾器看起來更像是選擇器，也就是：

       filterType=argument

 

所支持的元素過濾器爲：

value=valuePattern

         匹配元素時基於它們的值進行匹配。這在對一堆類似命名的關聯按鈕的篩選中顯得尤爲有用。

index=index

        選擇單個元素基於其在列表中的位置(從0開始)。

字符串匹配 式樣

有各類各樣的式樣語法可用於匹配字符串值：

·glob:pattern: 用″glob″去匹配一個字符串。″Glob″是一種用於命令行shells的表明性的有限正則表達式語法。在一個glob式樣中, ″*″表明任意序列字符集，而″?″則表明任意單個字符。Glob式樣匹配整個字符串。

·regexp:regexp: 使用正則表達式匹配字符串。可以使用全部的JavaScript正則表達式。

若是沒有指定式樣前綴，Selenium假定其爲″glob″式樣。

Selenium Actions

addLocationStrategy (strategyName, functionDefinition)

  爲selenium定義一個新的函數用於定位頁面上的元素。例如，若是你定義了一個方法″foo″,並運行了click(″foo=blah″)，咱們將運行你的函數，傳遞給你字符串″blah″，並點擊該函數所返回的元素，若是返回爲null，則拋出一個″Element not found″的錯誤。咱們將給該函數傳遞三個參數。

    ·locator: 用戶傳遞過來的字符串

    ·inWindow: 當前所選中的窗體

    ·inDocument: 當前所選中的文檔

若是未找到相應的元素，則函數必須返回一個null。

參數：

·strategyName – 定義的方法名；只能使用字母[a-zA-Z],不能包含空格或其餘標點符號。

·functionDefinition – 在JavaScript函數中的一個定義body的字符串。

如：return inDocument.getElementById(locator);

addSelection (locator, optioLocator)

爲經過使用選擇定位器，在一個可多選元素中所選擇的集合添加一個selection。@查看#doSelect關於選擇定位器的細節。

參數：

·locator – 用於指定一個多選框的元素定位器

·optionLocator – 一個選擇定位器(默認爲標籤)

allowNativeXpath (allow)

指定Selenium是否使用XPath的本地瀏覽執行(若是有可用的本地版本);若是傳遞的值爲″false″，咱們將使用pure-JavaScript xpath 庫。使用pure-JS xpath庫能夠提升xpath元素定位器在不一樣瀏覽器中的一致性，但其執行速度將大大低於本地執行。

參數：

·allow – Boolean,true意味着咱們更願意使用本地XPath;false則意味着咱們將只使用JS XPath

altKeyDown()

按下alt鍵並保持其按下狀態，直到doAltUp()被調用或一個新的頁面被加載。

altKeyUp()

釋放alt鍵

answerOnNextPrompt (answer)

通知Selenium返回下一次JavaScript prompt[window.prompt()]所指定的回答字符串。

參數：

  ·answer – 對彈出的提示所給與的回答

assignId (locator,identifier)

臨時爲指定元素設定一個″id″屬性，使你能夠在未來使用其ID，以代替緩慢且更復雜的XPath。該ID將在頁面重載後消失。

參數：

    ·locator – 指向某個元素的元素定位器

  ·identifier – 爲指定元素做爲ID使用的字符串

break()

暫停當前正在進行的測試，並等待用戶按下繼續按鈕。這個命令對於調試很是有用，但使用時要特別當心，由於他將強制暫停自動化測試，直到用戶手動操做。

check(locator)

勾選一個關聯性按鈕(checkbox/radio)

參數：

  ·locator – 一個元素定位器

chooseCancelOnNextConfirmation()

默認狀況下， Selenium的重載window.confirm()函數將返回true，等同於用戶手動點擊OK;執行該命令後，下一次調用confirm()將返回false，等同於用戶手動點擊了Cancel。Selenium對後來的確認動做將繼續使用默認行爲，自動返回true(OK),除非/直到你爲每一個確認動做明確的調用此命令。

chooseOkOnNextConfirmation()

撤銷調用chooseCancelOnNextConfirmation的效果。注意，Selenium的重載window.confirm()函數一般將自動返回true，等同於用戶手動點擊OK，所以你沒有必要使用此命令，除非因爲某種緣由使你在下一次確認動做前不得不改變你先前的想法。在任意確認動做後，Selenium對後來的確認動做將繼續使用默認行爲，自動返回true(OK),除非/直到你爲每一個確認動做明確的調用chooseCancelOnNextConfirmation()。

click(locator)

點擊一個連接、按鈕、多選框或單選框。若是該點擊事件致使了新的頁面加載(如同連接一般所做的)，將調用waitForPageToLoad。

參數：

  ·locator -一個元素定位器

clickAt(locator,coordString)

點擊一個連接、按鈕、多選框或單選框。若是該點擊事件致使了新的頁面加載(如同連接一般所做的)，將調用waitForPageToLoad。

參數：

  ·locator -一個元素定位器

·coordString – 指定由定位器返回的鼠標事件相關聯的元素x,y 座標(也就是 – 10,20)

close()

模擬用戶點擊彈出窗體或表單標題欄上的″關閉″按鈕。

controlKeyDown()

按下control鍵並保持其按下狀態，直到doControlUp()被調用或一個新的頁面被加載。

controlKeyUp()

釋放control鍵

createCookie(nameValuePair,optionsString)

建立一個新的cookie，除非你清楚的指定該cookie的路徑，不然其路徑和域將與當前測試的頁面相同。

參數：

  ·nameValuePair – 該cookie的名稱和值，使用以下格式″name=value″

·optionsString – 該cookie的選項。當前支持的選項包括’path’和’max_age’。optionsString的格式爲」path=/path/,max_age=60」。選項的順序可有可無。

deleteCookie(name,path)

刪除指定路徑下的該名稱cookie。

參數：

    ·name – 被刪除cookie的名稱

·path – 被刪除cookie的路徑屬性

doubleClick(locator)

雙擊一個連接、按鈕、多選框或單選框。若是該雙擊事件致使了新的頁面加載(如同連接一般所做的)，將調用waitForPageToLoad。

參數：

  ·locator - 一個元素定位器

doubleClickAt(locator,coordString)

雙擊一個連接、按鈕、多選框或單選框。若是該雙擊事件致使了新的頁面加載(如同連接一般所做的)，將調用waitForPageToLoad。

參數：

  ·locator - 一個元素定位器

·coordString – 指定由定位器返回的鼠標事件相關聯的元素x,y 座標(也就是 – 10,20)

dragAndDrop(locator,movementsString)

拖動元素必定的距離並放下

參數：

    ·locator - 一個元素定位器

  ·movementsString – 從當前位置到指定位置的像素偏移量，如,」+70,-300」

dragAndDropToObject(locatorOfObjectToBeDragged,locatorOfDragDestinationObject)

拖動元素到另外一元素

參數：

    ·locatorOfObjectToBeDragged – 被拖動的元素

·locatorOfDragDestinationObject – 被拖動的元素將拖向的元素的座標 (如，其最中心像素)

Dragdrop(locator,movementsString)

不建議 – 用dragAndDrop 代替

參數：

    ·locator - 一個元素定位器

·movementsString – 從當前位置到指定位置的像素偏移量，如,」+70,-300」

Echo(message)

打印指定消息到你的Selenese 表的第三個表單元。有利於調試。

參數：

    ·message – 要打印的消息

fireEvent(locator,eventName)

明確地模擬一個事件，觸發」onevent」響應句柄。

參數：

    ·locator - 一個元素定位器

    ·eventName – 事件名，如」focus」 或」blur」

getSpeed()

獲取執行速度(也就是，獲取接下來的每個selenium操做的延遲豪秒長度)。默認狀況下，是不會有延遲的。也就是延遲爲0毫秒。參照setSpeed。

goBack()

模擬用戶點擊其瀏覽器上的」back」按鈕

highlight(locator)

暫時將指定元素的背景色改變爲黃色。有利於調試。

參數：

    ·locator - 一個元素定位器

keyDown(locator,keySequence)

模擬用戶按下一個鍵(除了還沒釋放的)

參數：

    ·locator - 一個元素定位器

    ·keySequence – 能夠是個字符串(「/」後跟隨要被按下鍵的數字鍵碼，一般是該鍵的ASCII值)，或是個單字符，如「w「, 「/119「。

keyPress(locator,keySequence)

模擬用戶按下和釋放一個鍵。

參數：

    ·locator - 一個元素定位器

    ·keySequence – 能夠是個字符串(「/」後跟隨要被按下鍵的數字鍵碼，一般是該鍵的ASCII值)，或是個單字符，如「w「, 「/119「。

keyUp(locator,keySequence)

模擬用戶釋放一個鍵。

參數：

    ·locator - 一個元素定位器

    ·keySequence – 能夠是個字符串(「/」後跟隨要被按下鍵的數字鍵碼，一般是該鍵的ASCII值)，或是個單字符，如「w「, 「/119「。

metaKeyDown()

按下meta鍵並保持其按下狀態，直到doMetaUp()被調用或一個新的頁面被加載。

metaKeyUp()

釋放meta鍵

mouseDown(locator)

模擬用戶在指定元素上按下鼠標按鈕(除了還沒釋放的)。

參數：

    ·locator - 一個元素定位器

mouseDownAt(locator,coordString)

模擬用戶在指定位置上按下鼠標按鈕(除了還沒釋放的)。

參數：

    ·locator - 一個元素定位器

·coordString -指定由定位器返回的鼠標事件相關聯的元素x,y 座標(也就是 – 10,20)

mouseMove(locator)

模擬用戶在指定元素上按下鼠標按鈕(除了還沒釋放的)。

參數：

    ·locator - 一個元素定位器

mouseMoveAt(locator,coordString)

模擬用戶在指定位置上按下鼠標按鈕(除了還沒釋放的)。

參數：

    ·locator - 一個元素定位器

·coordString -指定由定位器返回的鼠標事件相關聯的元素x,y 座標(也就是 – 10,20)

mouseOut(locator)

模擬用戶從指定元素上移開鼠標指針。

參數：

    ·locator - 一個元素定位器

mouseOver(locator)

模擬用戶鼠標滑過指定元素。

參數：

    ·locator - 一個元素定位器

mouseUp(locator)

模擬用戶在指定元素上釋放鼠標按鈕時發生的事件(也就是，中止保持按鈕按下)。

參數：

    ·locator - 一個元素定位器

mouseUpAt(locator,coordString)

模擬用戶在指定元素上釋放鼠標按鈕時發生的事件(也就是，中止保持按鈕按下)。

參數：

    ·locator - 一個元素定位器

·coordString -指定由定位器返回的鼠標事件相關聯的元素x,y 座標(也就是 – 10,20)

open(url)

在測試框架中打開一個URL，能夠爲相對和絕對URLs。」open」命令將等待頁面加載完成才繼續進行，也就是明確的指名」並等待」後綴。注意：因爲瀏覽器安全策略(相同來源方針)這個URL必須和當前運行的HTML在相同的域。若是你不得不在另外一個域打開一個URL，則須要用Selenium服務在另外一個域去打開一個新的瀏覽器會話。

參數：

    ·url – 要打開的URL,能夠爲空

    ·windowID – 要選擇窗體的JavaScript window ID

pause(waitTime)

等待指定時間(以毫秒爲單位)

參數：

    ·waitTime – 要睡眠的時間(以毫秒爲單位)

refresh()

模擬用戶點擊瀏覽器上的」Refresh」按鈕。

removeAllSelections(locator)

取消全部可多選元素的選擇狀態。

參數：

    ·locator – 一個用於識別多選框的元素定位器

removeSelection(locator,optionLocator)

從用選項定位器進行篩選的多選元素的篩選集合中移除一個集合。@在#doSelect中查看選項定位器的詳細信息。

參數：

    ·locator – 一個用於識別多選框的元素定位器

    ·optionLocator – 一個選項定位器(默認爲一個標籤)

runScript(script)

在當前測試窗體的body中建立一個新的」script」標籤，並在body中添加指定的命令文本。用這種方式執行腳本，一般能夠比使用Selenium的」getEval」方式更簡易的進行調試。要注意的是，由這種腳本標籤所拋出的異常不受Selenium管理，所以當該腳本有可能會拋出異常時，你須要用try/catch塊將其包含起來。

    ·script – 須要執行的JavaScript 片斷

select(selectLocator,optionLocator)

用選項選擇器從一個下拉框中選擇一個選項。

選項選擇器提供不一樣的方法從一個HTML選擇元素中識別選項。(例如：選擇一個指定選項，或斷言一個知足某種規範的選項)有許多種形式的選擇選項定位器。

    ·label=labelPattern: 基於其標籤匹配選項，如其有效文本。(默認)

      〇 label=regexp:^[Oo]ther

    ·value=valuePattern: 基於其值匹配選項。

      〇 value=other

    ·id=id: 基於其id匹配選項。

      〇 id=option1

    ·index=index: 基於其索引匹配選項(從0開始)。

      〇index=2

若是沒有爲選項定位器提供前綴，則默認匹配爲標籤行爲。

參數：

    ·selectLocator – 一個用於識別下拉菜單的元素定位器

    ·optionLocator – 一個選項選擇器(默認爲標籤)

selectFrame(locator)

在當前窗體中選擇一個框架(你能夠屢次調用這個命令用於選擇嵌套框架)。要選擇父框架，用」relative=parent」做爲定位器；要選擇頂級框架，用」relative=top」。你一樣能夠經過基於0的索引號選擇框架；用」index=0」選擇第一個框架，或者用」index=2」選擇第三個框架。

你一樣能夠直接使用一個DOM表達式來識別你要的框架。像這樣：dom=frames[「main」].frames[「subframe」]

參數：

    ·locator – 一個用於識別框架或子框架的元素定位器

selectWindow(windowID)

選擇一個彈出窗體；一旦一個彈出窗體被選中，全部的命令將指向該窗體。要再次選擇主窗體，將對象設定爲null。

注意：window的內在JavaScript的」name」屬性和被給與的window文檔(一般是你實際看到的，做爲最終用戶，在窗體的標題欄上)的」title」之間有一個很大的不一樣。」name」對於最終用戶一般是不可見的；它是做爲第二個參數」windowName」傳遞給JavaScript函數window.open(url,windowName,windowFeatures,replaceFlag)(被Selenium截取)。

Selenium有許多方法用於查找被」windowID」參數所說起的窗體對象。

1.)    若是windowID爲null，(或是字符串」null」)，則假定爲用戶是提交給由瀏覽器最初實例化的窗體。

2.)    若是」windowID」參數的值是當前應用窗體的一個JavaScript變量名，則假定該變量包含一個由調用JavaScript window.open()函數所產生的返回值。

3.)    另外，selenium looks in a hash it maintains that maps string names to window 「names」.

4.)    若是失敗了，咱們將循環遍歷全部已知的窗體以便試圖找出適合的」title」。因爲」title」不是必須惟一，所以可能會產生一些非指望的行爲。

若是很難斷定你所要操做的窗體的名稱，你能夠查看爲識別經過window.open(被Selenium截取)所打開窗體的名稱時所產生的selenium 日誌消息。在每一個窗體被打開時，你一般能夠看到以下信息：

debug: window.open call intercepted; window ID (你能夠用於 selectWindow()) is 「myNewWindow」

在某些狀況，Selenium會沒法截取window.open的調用(例如，若是該調用發生在」onLoad」事件之間或以前)。(該BUG標記爲SEL-339)。在這些狀況，你可使用Selenium的openWindow命令強制Selenium去通告打開窗體的名稱，使用一個空(blank) url，像這樣：openWindow(「」,」myFunnyWindow」)。

參數：

    ·windowID – 要選擇窗體的JavaScript 窗體ID

setBrowserLogLevel(logLevel)

設定瀏覽器方日誌信息級別；在此級別之下的日誌信息將被丟棄。有效的日誌級別字符串有：」debug」，」info」，」warn」，」error」，或」off」。要查看瀏覽器日誌，在GUI模式下打開日誌窗口，或在Selenium RC中將瀏覽器端記入日誌設定爲enable。

參數：

    ·logLevel – 如下之一：」debug」，」info」，」warn」，」error」，或」off」

setCursorPosition(locator,position)

將文本光標移動到被給與的輸入元素或文本域的指定位置。若指定元素不是一個可輸入元素或文本域，該方法將失敗。

參數：

    ·locator – 一個指向輸入元素或文本域的元素定位器

    ·position – 該範圍的光標數字位置；position若是設定爲0，則爲該範圍域的最開始位置，你一樣能夠將光標設定爲-1以移動到該範圍域的最末端。

setMouseSpeed(pixels)

配置在dragAndDrop 命令執行期間，」mousemove」事件時的像素數字(默認爲10)。

將這個值設定爲0，意味着咱們將向從開始位置到結束位置的每個像素髮送一個」mousemove」事件；那將會很是緩慢，且可能致使某些瀏覽器將該JavaScript強制設定爲超時。

若是該鼠標速度大於兩個拖動對象間的距離，咱們將只向開始位置和結束位置發送一個」mousemove」事件。

參數：

    ·pixels – 兩個「mousemove」事件間的像素間隔

setSpeed(value)

設定執行速度(也就是說，設定將要執行的每條selenium操做間的毫秒延遲間隔長度)。默認狀況下，沒有延遲，也就是延遲爲0毫秒。

參數：

    ·value – 在操做後的暫停毫秒數

setTimeout(timeout)

指定Selenium等待動做完成的等待時間。

須要等待的動做包括」open」和」waitFor*」。

默認超時爲30秒。

參數：

    ·timeout – 以毫秒爲單位，超事後該命令將返回錯誤。

shiftKeyDown()

按下shift鍵，並保持按下狀態，直到doShiftUp()被調用或一個新的頁面被加載。

shiftKeyUp()

釋放shift鍵。

store(expression,variableName)

該命令是存儲表達式的同義詞。

參數：

    ·expression – 要存儲的值

    ·variableName – 用於存儲結果的變量名

submit(formLocator)

提交給指定表單。這對於沒有提交按鈕的表單特別有用，如，簡單輸入的」search」表單。

參數：

    ·formLocator – 一個指向你要提交的表單的元素定位器

type(locator,value)

設定一個輸入域的值，如同你輸入進去同樣。

其一樣可用於單選框，多選框等。在這些狀況，value應爲選項選擇時的值，而不是有效文本。

參數：

    ·locator – 一個元素定位器

    ·value – 要錄入的值

typeKeys(locator,value)

模擬在指定元素上的按鍵事件，如同是你一個鍵一個鍵敲上去同樣。

比起爲指定字符串的每一個字符調用keyDown,keyUp,keyPress方法，這個函數要方便的多；其對於須要明確按鍵事件的動態UI組件(如自動完成的combo box)一樣有用。

不一樣於簡單的」敲打」命令——將指定值直接強制賦給頁面，該指令可能有，也可能沒有任何效果，即時在敲打按鈕一般會有效的狀況下。例如，若是你在一個表單元素上使用」typeKeys」，你可能能夠，也可能不能夠看到看到你在該區域錄入的效果。

在有些時候，你可能不得不使用簡單的」type」命令去設定域的值，而後用」typeKeys」命令去發送按鍵事件以告知你所錄入的值。

參數：

    ·locator – 一個元素定位器

    ·value – 要錄入的值

uncheck(locator)

取消選中一個關聯性按鈕(checkbox/radio)

參數：

    ·locator – 一個元素定位器

waitForCondition(script,timeout)

重複執行指定JavaScript片斷直到其值爲」true」。

該片斷能夠有多行，但只考慮其最後一行的結果。

要注意：默認狀況下，該片斷會在運行者的測試窗體運行，而不是在你的應用程序窗體。要獲得你的應用程序窗體，你可使用JavaScript片斷selenium.browserbot.getCurrentWindow()，而後讓你的JavaScript在那運行。

參數：

    ·script – 要運行的JavaScript片斷

    ·timeout –以毫秒爲單位，超事後該命令將返回錯誤。

waitForFrameToLoad(frameAddress,timeout)

等待一個新的框架加載。

Selenium一般會持續跟蹤新頁面和框架的加載狀態，當其第一次注意到頁面加載完成，將會設定一個」newPageLoaded」標誌。

查看waitForPageToLoad得到更多信息。

參數：

    ·frameAddress – 服務端的框架地址

    ·timeout - 以毫秒爲單位，超事後該命令將返回錯誤。

waitForPageToLoad(timeout)

等待一個新的頁面加載。

你可使用此命令以代替」AndWait」後綴，」clickAndWait」，」selectAndWait」，」typeAndWait」等(僅在JS API中有效)。

Selenium一般會持續跟蹤新頁面的加載狀態，當其第一次注意到頁面加載完成，將會設定一個」newPageLoaded」標誌。當此標誌變爲false後再運行其餘Selenium命令。所以，若是你要等待一個頁面加載完成，當一個Selenium命令致使一個頁面加載後就需當即開始等待。

參數：

    ·timeout - 以毫秒爲單位，超事後該命令將返回錯誤。

waitForPopUp(windowID,timeout)

等待一個彈出窗體出現和加載。

參數：

    ·windowID – 將出現窗體的JavaScript 窗體ID

    ·timeout - 以毫秒爲單位，超事後該命令將返回錯誤。

windowFocus()

將焦點賦給當前選擇窗體

windowMaximize()

從新設定當前窗體大小爲全屏

 

Selenium Accessors

assertErrorOnNext(message)

告訴Selenium在下一個命令執行時期待有錯誤。

參數：

    ·message – 咱們所指望的錯誤信息。若是出現不正確的錯誤信息，該命令將失敗。

同斷言相關聯，自動生成：

    ·assertNotErrorOnNext(message)

    ·verifyErrorOnNext(message)

    ·verifyNotErrorOnNext(message)

    ·waitForErrorOnNext(message)

    ·waitForNotErrorOnNext(message)

assertFailureOnNext(message)

告訴Selenium在下一個命令執行時期待有失敗。

參數：

    ·message – 咱們所指望的失敗信息。若是出現不正確的失敗信息，該命令將失敗。

同斷言相關聯，自動生成：

    ·assertNotFailureOnNext(message)

  ·verifyFailureOnNext(message)

  ·verifyNotFailureOnNext(message)

  ·waitForFailureOnNext(message)

  ·waitForNotFailureOnNext(message)

assertSelected(selectLocator,optionLocator)

驗證從下拉框中選擇的選項知足選項指定器。

注意，不同意使用該命令；你應該使用assertSelectedLabel, assertSelectedValue, assertSelectedIndex,或assertSelectedId進行代替。

查看選擇命令獲取更多關於選擇定位器的信息。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·optionLocator – 一個選項定位器，表明性的就是一個選項標籤(如」John Smith」)

同斷言相關聯，自動生成：

    ·assertNotSelected(selectLocator,optionLocator)

  ·verifySelected(selectLocator,optionLocator)

  ·verifyNotSelected(selectLocator,optionLocator)

  ·waitForSelected(selectLocator,optionLocator)

  ·waitForNotSelected(selectLocator,optionLocator)

storeAlert(variableName)

返回在以前動做所產生的JavaScript警告消息，若是沒有警告將失敗。

獲得一個警告同手動點擊OK有着相同的效果。若是產生了一個警告，而你並不去獲得/驗證它，那麼下一個Selenium動做將失敗。

注意：在Selenium中，JavaScript警告將不會彈出一個可見的警告對話框。

注意：Selenium不支持在頁面的onload()事件句柄中所產生的JavaScript警告。在這種狀況下，將會生成一個可見的對話框，Selenium將被懸停直到手動點擊OK。

Returns:

  最近JavaScript的警告消息

同斷言相關聯，自動生成：

    ·assertAlert(pattern)

  ·assertNotAlert(pattern)

  ·verifyAlert(pattern)

  ·verifyNotAlert(pattern)

  ·waitForAlert(pattern)

  ·waitForNotAlert(pattern)

storeAllButtons(variableName)

返回頁面上全部按鈕的ID集。

若是被給與的按鈕沒有ID，則將在結果數組中顯示爲」」。

Returns:

  頁面上全部按鈕的ID集。

同斷言相關聯，自動生成：

    ·assertAllButtons(pattern)

    ·assertNotAllButtons(pattern)

    ·verifyAllButtons(pattern)

    ·verifyNotAllButtons(pattern)

    ·waitForAllButtons(pattern)

    ·waitForNotAllButtons(pattern)

storeAllFields(variableName)

返回頁面上全部可輸入域的ID集。

若是被給與的域沒有ID，則將在結果數組中顯示爲」」

Returns:

  頁面上全部域的ID集。

同斷言相關聯，自動生成：

    ·assertAllFields(pattern)

    ·assertNotAllFields (pattern)

    ·verifyAllFields (pattern)

    ·verifyNotAllFields (pattern)

    ·waitForAllFields (pattern)

    ·waitForNotAllFields (pattern)

storeAllLinks(variableName)

返回頁面上全部連接的ID集。

若是被給與的連接沒有ID，則將在結果數組中顯示爲」」

Returns:

  頁面上全部連接的ID集。

同斷言相關聯，自動生成：

    ·assertAllLinks(pattern)

    ·assertNotAllLinks (pattern)

    ·verifyAllLinks (pattern)

    ·verifyNotAllLinks (pattern)

    ·waitForAllLinks (pattern)

    ·waitForNotAllLinks (pattern)

storeAllWindowIds(variableName)

返回全部瀏覽器已知的窗體ID集。

Returns:

  全部瀏覽器已知的窗體ID集。

同斷言相關聯，自動生成：

    ·assertAllWindowIds (pattern)

  ·assertNotAllWindowIds (pattern)

  ·verifyAllWindowIds (pattern)

  ·verifyNotAllWindowIds (pattern)

  ·waitForAllWindowIds (pattern)

  ·waitForNotAllWindowIds (pattern)

storeAllWindowNames(variableName)

返回全部瀏覽器已知的窗體名稱集。

Returns:

  全部瀏覽器已知的窗體名稱集。

同斷言相關聯，自動生成：

    ·assertAllWindowNames (pattern)

  ·assertNotAllWindowNames (pattern)

  ·verifyAllWindowNames (pattern)

  ·verifyNotAllWindowNames (pattern)

  ·waitForAllWindowNames (pattern)

  ·waitForNotAllWindowNames (pattern)

storeAllWindowTitles(variableName)

返回全部瀏覽器已知的窗體標題集。

Returns:

  全部瀏覽器已知的窗體標題集。

同斷言相關聯，自動生成：

    ·assertAllWindowTitles (pattern)

  ·assertNotAllWindowTitles (pattern)

  ·verifyAllWindowTitles (pattern)

  ·verifyNotAllWindowTitles (pattern)

  ·waitForAllWindowTitles (pattern)

  ·waitForNotAllWindowTitles (pattern)

storeAttribute(attributeLocator,variableName)

得到一個元素屬性值。

參數：

    ·attributeLocator – 由@符號開頭，後跟隨屬性名，如」foo@bar」

    ·variableName – 用於存儲結果的變量名。

Returns:

  指定屬性的值

同斷言相關聯，自動生成：

    ·assertAttribute (attributeLocator, pattern)

  ·assertNotAttribute (attributeLocator, pattern)

  ·verifyAttribute (attributeLocator, pattern)

  ·verifyNotAttribute (attributeLocator, pattern)

  ·waitForAttribute (attributeLocator, pattern)

  ·waitForNotAttribute (attributeLocator, pattern)

storeAttributeFromAllWindows(attributeName,variableName)

返回全部已知窗體的某些屬性的每個實例。

參數：

    ·attributeName – 窗體某屬性的名稱

    ·variableName - 用於存儲結果的變量名。

Returns:

  從全部已知窗體得到的該屬性的數值集。

同斷言相關聯，自動生成：

    ·assertAttributeFromAllWindows (attributeName, pattern)

  ·assertNotAttributeFromAllWindows (attributeName, pattern)

  ·verifyAttributeFromAllWindows (attributeName, pattern)

  ·verifyNotAttributeFromAllWindows (attributeName, pattern)

  ·waitForAttributeFromAllWindows (attributeName, pattern)

  ·waitForNotAttributeFromAllWindows (attributeName, pattern)

storeBodyText(variableName)

獲取頁面上全部文本。

Returns:

  頁面上全部文本

同斷言相關聯，自動生成：

    ·assertBodyText (pattern)

  ·assertNotBodyText (pattern)

  ·verifyBodyText (pattern)

  ·verifyNotBodyText (pattern)

  ·waitForBodyText (pattern)

  ·waitForNotBodyText (pattern)

storeConfirmation(variableName)

返回在以前動做所產生的JavaScript確認消息。

默認狀況下，confirm函數將返回true，同手動點擊OK有着相同的效果。這能夠經過以前執行chooseCancelOnNextConfirmation命令改變。若是產生了一個確認，而你並不去獲得/驗證它，那麼下一個Selenium動做將失敗。

注意：在Selenium中，JavaScript確認將不會彈出一個可見的對話框。

注意：Selenium不支持在頁面的onload()事件句柄中所產生的JavaScript警告。在這種狀況下，將會生成一個可見的對話框，Selenium將被懸停直到手動點擊OK。

Returns:

  最近JavaScript的確認消息

同斷言相關聯，自動生成：

    ·assertConfirmation (pattern)

  ·assertNotConfirmation (pattern)

  ·verifyConfirmation (pattern)

  ·verifyNotConfirmation (pattern)

  ·waitForConfirmation (pattern)

  ·waitForNotConfirmation (pattern)

storeCookie(variableName)

返回當前測試下當前頁面的全部cookies

Returns:

  當前測試下當前頁面的全部cookies

同斷言相關聯，自動生成：

    ·assertCookie (pattern)

  ·assertNotCookie (pattern)

  ·verifyCookie (pattern)

  ·verifyNotCookie (pattern)

  ·waitForCookie (pattern)

  ·waitForNotCookie (pattern)

storeCursorPosition(locator,variableName)

返回所給與的輸入元素或文本域的文本光標位置。

要注意，這並不在全部的瀏覽器中有效。

特別指出，若是光標/選擇已經被JavaScript所清除，該命令將嘗試返回光標所在的最後位置，即便光標已經不在該頁面。這被歸檔爲SEL-243。

若是指定元素不是一個可輸入元素或文本域，或沒有光標在此元素上，該方法將失敗。

參數：

    ·locator – 一個指向輸入元素或文本域的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  在該域中的光標數字位置

同斷言相關聯，自動生成：

    ·assertCursorPosition (locator,pattern)

  ·assertNotCursorPosition (locator,pattern)

  ·verifyCursorPosition (locator,pattern)

  ·verifyNotCursorPosition (locator,pattern)

  ·waitForCursorPosition (locator,pattern)

  ·waitForNotCursorPosition (locator,pattern)

storeElementHeight(locator,variableName)

返回元素的高度

參數：

    ·locator – 一個指向元素的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  元素的高度

同斷言相關聯，自動生成：

    ·assertElementHeight (locator,pattern)

  ·assertNotElementHeight (locator,pattern)

  ·verifyElementHeight (locator,pattern)

  ·verifyNotElementHeight (locator,pattern)

  ·waitForElementHeight (locator,pattern)

  ·waitForNotElementHeight (locator,pattern)

storeElementIndex(locator,variableName)

獲取元素相對於其父元素的索引(從0開始)。註釋節點和空文本節點將被忽略。

參數：

    ·locator – 一個指向元素的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  元素相對於其父元素的索引(從0開始)

同斷言相關聯，自動生成：

    ·assertElementIndex (locator,pattern)

  ·assertNotElementIndex (locator,pattern)

  ·verifyElementIndex (locator,pattern)

  ·verifyNotElementIndex (locator,pattern)

  ·waitForElementIndex (locator,pattern)

  ·waitForNotElementIndex (locator,pattern)

storeElementPositionLeft(locator,variableName)

返回元素的水平位置

參數：

    ·locator – 一個指向元素的元素定位器或元素自己

    ·variableName - 用於存儲結果的變量名。

Returns:

  到框架邊緣的像素。

同斷言相關聯，自動生成：

    ·assertElementPositionLeft (locator,pattern)

  ·assertNotElementPositionLeft (locator,pattern)

  ·verifyElementPositionLeft (locator,pattern)

  ·verifyNotElementPositionLeft (locator,pattern)

  ·waitForElementPositionLeft (locator,pattern)

  ·waitForNotElementPositionLeft (locator,pattern)

storeElementPositionTop(locator,variableName)

返回元素的縱向位置

參數：

    ·locator – 一個指向元素的元素定位器或元素自己

    ·variableName - 用於存儲結果的變量名。

Returns:

  到框架邊緣的像素。

同斷言相關聯，自動生成：

    ·assertElementPositionTop (locator,pattern)

  ·assertNotElementPositionTop (locator,pattern)

  ·verifyElementPositionTop (locator,pattern)

  ·verifyNotElementPositionTop (locator,pattern)

  ·waitForElementPositionTop (locator,pattern)

  ·waitForNotElementPositionTop (locator,pattern)

storeElementWidth(locator,variableName)

返回元素的寬度

參數：

    ·locator – 一個指向元素的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  元素的寬度(以像素爲單位)

同斷言相關聯，自動生成：

    ·assertElementWidth (locator,pattern)

  ·assertNotElementWidth (locator,pattern)

  ·verifyElementWidth (locator,pattern)

  ·verifyNotElementWidth (locator,pattern)

  ·waitForElementWidth (locator,pattern)

  ·waitForNotElementWidth (locator,pattern)

storeEval(script,variableName)

得到指定JavaScript片斷執行後的值。該片斷能夠有多行，但只返回最後一行的值。要注意到，默認狀況下，該片斷將在」selenium」對象自己的上下文中運行，所以其將提交給Selenium對象。用window將窗體提交給你的應用程序，如：

window.document.getElementById(‘foo’)

若是你不得不在你的應用程序頁面使用一個定位器提交一個單元素，你能夠用this.browserbot.findElement(「id=foo」)，這裏」id=foo」就是你的定位器。

參數：

    ·script – 要運行的JavaScript

    ·variableName - 用於存儲結果的變量名。

Returns:

  片斷執行後的值

同斷言相關聯，自動生成：

    ·assertEval (script,pattern)

  ·assertNotEval (script,pattern)

  ·verifyEval (script,pattern)

  ·verifyNotEval (script,pattern)

  ·waitForEval (script,pattern)

  ·waitForNotEval (script,pattern)

storeExpression(expression,variableName)

返回指定表達式。

因爲JavaScript的預處理機制使其顯得很是有用。它能夠用於生成如assertExpression和waitForExpression命令。

參數：

    ·expression – 要返回的值

    ·variableName - 用於存儲結果的變量名。

Returns:

  經過的值

同斷言相關聯，自動生成：

    ·assertExpression (expression,pattern)

  ·assertNotExpression (expression,pattern)

  ·verifyExpression (expression,pattern)

  ·verifyNotExpression (expression,pattern)

  ·waitForExpression (expression,pattern)

  ·waitForNotExpression (expression,pattern)

storeHtmlSource(variableName)

返回」html」標籤間的整個HTML源代碼。

Returns:

  整個HTML源代碼

同斷言相關聯，自動生成：

    ·assertHtmlSource (pattern)

  ·assertNotHtmlSource (pattern)

  ·verifyHtmlSource (pattern)

  ·verifyNotHtmlSource (pattern)

  ·waitForHtmlSource (pattern)

  ·waitForNotHtmlSource (pattern)

storeLocation(variableName)

取得當前頁面的絕對路徑

Returns:

  當前頁面的絕對路徑

同斷言相關聯，自動生成：

    ·assertLocation (pattern)

  ·assertNotLocation (pattern)

  ·verifyLocation (pattern)

  ·verifyNotLocation (pattern)

  ·waitForLocation (pattern)

  ·waitForNotLocation (pattern)

storeMouseSpeed(variableName)

返回在dragAndDrop 命令執行期間，」mousemove」事件時的像素數字(默認爲10)

Returns:

  dragAndDrop 命令執行期間，」mousemove」事件時的像素數字(默認爲10)

同斷言相關聯，自動生成：

    ·assertMouseSpeed (pattern)

  ·assertNotMouseSpeed (pattern)

  ·verifyMouseSpeed (pattern)

  ·verifyNotMouseSpeed (pattern)

  ·waitForMouseSpeed (pattern)

  ·waitForNotMouseSpeed (pattern)

storePrompt(variableName)

返回在以前動做所產生的JavaScript問題提示消息。

要成功掛起問題提示須要先運行answerOnNextPrompt命令。若是產生了一個問題提示，而你並不去獲得/驗證它，那麼下一個Selenium動做將失敗。

注意：在Selenium中，JavaScript確認將不會彈出一個可見的對話框。

注意：Selenium不支持在頁面的onload()事件句柄中所產生的JavaScript問題提示。在這種狀況下，將會生成一個可見的對話框，Selenium將被懸停直到手動點擊OK。

Returns:

  最近JavaScript的問題提示消息

同斷言相關聯，自動生成：

    ·assertPrompt (pattern)

  ·assertNotPrompt (pattern)

  ·verifyPrompt (pattern)

  ·verifyNotPrompt (pattern)

  ·waitForPrompt (pattern)

  ·waitForNotPrompt (pattern)

storeSelectedId(selectLocator,variableName)

獲取從指定選擇元素中選擇的選項元素ID。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  從指定選擇元素中選擇的選項元素ID

同斷言相關聯，自動生成：

    ·assertSelectedId (selectLocator,pattern)

  ·assertNotSelectedId (selectLocator,pattern)

  ·verifySelectedId (selectLocator,pattern)

  ·verifyNotSelectedId (selectLocator,pattern)

  ·waitForSelectedId (selectLocator,pattern)

  ·waitForNotSelectedId (selectLocator,pattern)

storeSelectedIds(selectLocator,variableName)

從指定選擇或多選元素中獲取選擇的選項元素ID集。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  從指定選擇或多選元素中選擇的選項元素ID集合數組

同斷言相關聯，自動生成：

    ·assertSelectedIds (selectLocator,pattern)

  ·assertNotSelectedIds (selectLocator,pattern)

  ·verifySelectedIds (selectLocator,pattern)

  ·verifyNotSelectedIds (selectLocator,pattern)

  ·waitForSelectedIds (selectLocator,pattern)

  ·waitForNotSelectedIds (selectLocator,pattern)

storeSelectedIndex(selectLocator,variableName)

從指定的選擇元素中獲取被選項索引(從0開始)。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  從指定選擇元素中選擇的選項元素索引

同斷言相關聯，自動生成：

    ·assertSelectedIndex (selectLocator,pattern)

  ·assertNotSelectedIndex (selectLocator,pattern)

  ·verifySelectedIndex (selectLocator,pattern)

  ·verifyNotSelectedIndex (selectLocator,pattern)

  ·waitForSelectedIndex (selectLocator,pattern)

  ·waitForNotSelectedIndex (selectLocator,pattern)

storeSelectedIndexs(selectLocator,variableName)

從指定的選擇或多選元素中獲取被選項索引(從0開始)集。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  從指定選擇或多選元素中選擇的選項元素索引集合數組

同斷言相關聯，自動生成：

    ·assertSelectedIndexs (selectLocator,pattern)

  ·assertNotSelectedIndexs (selectLocator,pattern)

  ·verifySelectedIndexs (selectLocator,pattern)

  ·verifyNotSelectedIndexs (selectLocator,pattern)

  ·waitForSelectedIndexs (selectLocator,pattern)

  ·waitForNotSelectedIndexs (selectLocator,pattern)

storeSelectedLabel(selectLocator,variableName)

從指定的選擇元素中獲取所選擇的選項標籤(可見文本)。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

所選擇的選項標籤

同斷言相關聯，自動生成：

    ·assertSelectedLabel (selectLocator,pattern)

  ·assertNotSelectedLabel (selectLocator,pattern)

  ·verifySelectedLabel (selectLocator,pattern)

  ·verifyNotSelectedLabel (selectLocator,pattern)

  ·waitForSelectedLabel (selectLocator,pattern)

  ·waitForNotSelectedLabel (selectLocator,pattern)

storeSelectedLabels(selectLocator,variableName)

從指定的選擇或多選元素中獲取所選擇的選項標籤(可見文本)。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

所選擇的選項標籤

同斷言相關聯，自動生成：

    ·assertSelectedLabel (selectLocator,pattern)

  ·assertNotSelectedLabel (selectLocator,pattern)

  ·verifySelectedLabel (selectLocator,pattern)

  ·verifyNotSelectedLabel (selectLocator,pattern)

  ·waitForSelectedLabel (selectLocator,pattern)

  ·waitForNotSelectedLabel (selectLocator,pattern)

storeSelectedValue(selectLocator,variableName)

從指定的選擇元素中獲取所選擇的選項值(值屬性)。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

所選擇的選項值

同斷言相關聯，自動生成：

    ·assertSelectedValue (selectLocator,pattern)

  ·assertNotSelectedValue (selectLocator,pattern)

  ·verifySelectedValue (selectLocator,pattern)

  ·verifyNotSelectedValue (selectLocator,pattern)

  ·waitForSelectedValue (selectLocator,pattern)

  ·waitForNotSelectedValue (selectLocator,pattern)

storeSelectedValues(selectLocator,variableName)

從指定的選擇或多選元素中獲取全部所選擇的選項值(值屬性)。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

全部所選擇的選項值數組

同斷言相關聯，自動生成：

    ·assertSelectedValues (selectLocator,pattern)

  ·assertNotSelectedValues (selectLocator,pattern)

  ·verifySelectedValues (selectLocator,pattern)

  ·verifyNotSelectedValues (selectLocator,pattern)

  ·waitForSelectedValues (selectLocator,pattern)

  ·waitForNotSelectedValues (selectLocator,pattern)

storeSelectOptions(selectLocator,variableName)

獲取指定選擇下拉框的選項標籤。

參數：

    ·selectLocator - 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

指定選擇下拉框的選項標籤數組

同斷言相關聯，自動生成：

    ·assertSelectedOptions (selectLocator,pattern)

  ·assertNotSelectedOptions (selectLocator,pattern)

  ·verifySelectedOptions (selectLocator,pattern)

  ·verifyNotSelectedOptions (selectLocator,pattern)

  ·waitForSelectedOptions (selectLocator,pattern)

  ·waitForNotSelectedOptions (selectLocator,pattern)

storeTable(tableCellAddress,variableName)

從某個表的單元格中獲取文本。單元格地址語法如tablelocator.row.column，這裏的row和column從0開始。

參數：

    ·tableCellAddress – 一個單元格地址，如」foo.1.4」

    ·variableName -用於存儲結果的變量名。

Returns:

  從指定單元格取出的文本

同斷言相關聯，自動生成：

    ·assertTable (tableCellAddress,pattern)

  ·assertNotTable (tableCellAddress,pattern)

  ·verifyTable (tableCellAddress,pattern)

  ·verifyNotTable (tableCellAddress,pattern)

  ·waitForTable (tableCellAddress,pattern)

  ·waitForNotTable (tableCellAddress,pattern)

storeText(locator,variableName)

獲取元素的文本。這對任何包含文本的元素都有效。該命令便可以用於如火狐瀏覽器的textContent，也能夠用於如IE瀏覽器的innerText——顯示給用戶的。

參數：

    ·locator - 一個元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  元素的文本

同斷言相關聯，自動生成：

    ·assertText (locator,pattern)

  ·assertNotText (locator,pattern)

  ·verifyText (locator,pattern)

  ·verifyNotText (locator,pattern)

  ·waitForText (locator,pattern)

  ·waitForNotText (locator,pattern)

storeTitle(variableName)

獲取當前頁面的標題。

Returns:

  當前頁面的標題。

同斷言相關聯，自動生成：

    ·assertTitle (pattern)

  ·assertNotTitle (pattern)

  ·verifyTitle (pattern)

  ·verifyNotTitle (pattern)

  ·waitForTitle (pattern)

  ·waitForNotTitle (pattern)

storeValue(locator,variableName)

得到一個輸入域(或任何包含value參數的元素)的值(已去除空格)。對於checkbox/radio元素，其值爲」on」仍是」off」依賴於該元素是否被選中。

參數：

    ·locator - 一個元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  元素值，對於checkbox/radio元素則爲」on/off」

同斷言相關聯，自動生成：

    ·assertValue (locator,pattern)

  ·assertNotValue (locator,pattern)

  ·verifyValue (locator,pattern)

  ·verifyNotValue (locator,pattern)

  ·waitForValue (locator,pattern)

  ·waitForNotValue (locator,pattern)

storeWhetherThisFrameMatchFrameExpression(currenFrameString,target,variableName)

肯定當前框架是否包含該運行代碼。

這對於代理注入代碼模式很是有用，這些代碼在每一個瀏覽器框架和窗體中運行，有時selenium server須要識別當前是哪一個框架。這種狀況下，當測試調用selectFrame，該程序將被每一個框架調用以指出哪一個框架被選擇。被選擇的框架將返回true，而其餘將返回false。

參數：

    ·currenFrameString – 開始框架

    ·target – 新框架(也許與當前框架相關聯)

    ·variableName -用於存儲結果的變量名。

Returns:

  若是新框架爲該代碼的窗體，返回true

同斷言相關聯，自動生成：

    ·assertWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·assertNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·verifyWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·verifyNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·waitForWhetherThisFrameMatchFrameExpression (currenFrameString, target)

  ·waitForNotWhetherThisFrameMatchFrameExpression (currenFrameString, target)

storeWhetherThisWindowMatchWindowExpression(currenWindowString,target,variableName)

肯定當前窗體是否包含該運行代碼。

這對於代理注入代碼模式很是有用，這些代碼在每一個瀏覽器框架和窗體中運行，有時selenium server須要識別當前是哪一個窗體。這種狀況下，當測試調用selectWindow，該程序將被每一個窗體調用以指出哪一個窗體被選擇。被選擇的窗體將返回true，而其餘將返回false。

參數：

    ·currenFrameString – 開始窗體

    ·target – 新窗體(也許與當前窗體相關聯，如，」_parent」)

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是新窗體爲該代碼的窗體，返回true

同斷言相關聯，自動生成：

    ·assertWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·assertNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·verifyWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·verifyNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·waitForWhetherThisWindowMatchWindowExpression (currenWindowString, target)

  ·waitForNotWhetherThisWindowMatchWindowExpression (currenWindowString, target)

storeXpathCount(xpath,variableName)

返回匹配指定xpath的節點數，如」//table」將給出表的個數。

參數：

·xpath – 要計算的xpath表達式。不要用’count()’函數將該表達式包含起來，咱們將自動幫你做這件事。

    ·variableName - 用於存儲結果的變量名。

Returns:

  匹配指定xpath的節點數

同斷言相關聯，自動生成：

    ·assertXpathCount (xpath, pattern)

  ·assertNotXpathCount (xpath, pattern)

  ·verifyXpathCount (xpath, pattern)

  ·verifyNotXpathCount (xpath, pattern)

  ·waitForXpathCount (xpath, pattern)

  ·waitForNotXpathCount (xpath, pattern)

storeAlertPresent(variableName)

發生警告了?

該函數永遠不會拋出異常

Returns:

  若是有警告返回true

同斷言相關聯，自動生成：

    ·assertAlertPresent ()

  ·assertNotAlertPresent ()

  ·verifyAlertPresent ()

  ·verifyNotAlertPresent ()

  ·waitForAlertPresent ()

  ·waitForNotAlertPresent ()

storeChecked(locator,variableName)

獲取一個關聯性按鈕(checkbox/radio)是否被勾選。若是指定元素不存在或不是一個關聯性按鈕，將失敗。

參數：

    ·locator– 一個執行checkbox或radio按鈕的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是該checkbox被勾選，返回true,不然返回false

同斷言相關聯，自動生成：

    ·assertChecked (locator)

  ·assertNotChecked (locator)

  ·verifyChecked (locator)

  ·verifyNotChecked (locator)

  ·waitForChecked (locator)

  ·waitForNotChecked (locator)

storeConfirmationPresent(variableName)

confirm()被調用了？

該函數永遠不會拋出異常

Returns:

  若是有一個未決的確認返回true

同斷言相關聯，自動生成：

    ·assertConfirmationPresent ()

  ·assertNotConfirmationPresent ()

  ·verifyConfirmationPresent ()

  ·verifyNotConfirmationPresent ()

  ·waitForConfirmationPresent ()

  ·waitForNotConfirmationPresent ()

storeEditable(locator,variableName)

斷定指定的輸入元素是否爲可編輯，且ie沒有被禁用。若是指定元素不爲一個可輸入元素，該函數將失敗。

參數：

    ·locator – 一個元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是輸入元素可編輯返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertEditable (locator)

  ·assertNotEditable (locator)

  ·verifyEditable (locator)

  ·verifyNotEditable (locator)

  ·waitForEditable (locator)

  ·waitForNotEditable (locator)

storeElementPresent(locator,variableName)

驗證指定元素在頁面上。

參數：

    ·locator – 一個元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是該元素出現返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertElementPresent (locator)

  ·assertNotElementPresent (locator)

  ·verifyElementPresent (locator)

  ·verifyNotElementPresent (locator)

  ·waitForElementPresent (locator)

  ·waitForNotElementPresent (locator)

storeOrdered(locator1,locator2,variableName)

檢查這兩個元素是否有相同的父級，且在DOM中爲順序親屬。兩個相同元素將不考慮順序。

參數：

    ·locator1 – 指向第一個元素的元素定位器

    ·locator2 – 指向第二個元素的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是元素1是元素2的兄長，返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertOrdered (locator1,locator2)

  ·assertNotOrdered (locator1,locator2)

  ·verifyOrdered (locator1,locator2)

  ·verifyNotOrdered (locator1,locator2)

  ·waitForOrdered (locator1,locator2)

  ·waitForNotOrdered (locator1,locator2)

storePromptPresent(variableName)

發生提示了？

該函數永遠不會拋出異常

Returns:

  若是有一個未決的提示返回true

同斷言相關聯，自動生成：

    ·assertPromptPresent ()

  ·assertNotPromptPresent ()

  ·verifyPromptPresent ()

  ·verifyNotPromptPresent ()

  ·waitForPromptPresent ()

  ·waitForNotPromptPresent ()

storeSomethingSelected(selectLocator,variableName)

斷定一個下拉菜單是否選擇了某個選項。

參數：

    ·selectLocator – 一個用於識別下拉菜單的元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是選擇某選項返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertSomethingSelected (selectLocator)

  ·assertNotSomethingSelected (selectLocator)

  ·verifySomethingSelected (selectLocator)

  ·verifyNotSomethingSelected (selectLocator)

  ·waitForSomethingSelected (selectLocator)

  ·waitForNotSomethingSelected (selectLocator)

storeTextPresent(pattern,variableName)

驗證指定文本出如今提交給用戶的頁面上。

參數：

    ·pattern – 用於匹配頁面文本的範式

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是該範式匹配文本返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertTextPresent (pattern)

  ·assertNotTextPresent (pattern)

  ·verifyTextPresent (pattern)

  ·verifyNotTextPresent (pattern)

  ·waitForTextPresent (pattern)

  ·waitForNotTextPresent (pattern)

storeVisible(locator,variableName)

斷定指定元素是否可見。一個元素能夠經過將其自己或其父級的CSS」visibility」屬性設定爲」hidden」，或將」dispaly」屬性設定爲」none」，以使其不可見。若是該元素不存在，此方法將失敗。

參數：

    ·locator – 一個元素定位器

    ·variableName - 用於存儲結果的變量名。

Returns:

  若是指定元素爲可見返回true，不然返回false

同斷言相關聯，自動生成：

    ·assertVisible (locator)

  ·assertNotVisible (locator)

  ·verifyVisible (locator)

  ·verifyNotVisible (locator)

  ·waitForVisible (locator)

  ·waitForNotVisible (locator)

參數解釋和變量