Selenium2Library關鍵字（1）
對Selenium2Library關鍵字的整理和翻譯。英文不好，僅供參考。

1.Add Cookie [ name | value | path=None | domain=None | secure=None | expiry=None ]
給你當前的會話增加一個cookie。"name"和"value"，"path","domain"和"secure"是可選項。

2.Alert Should Be Present [text=]
驗證Alert是否存在并且消除它。如果‘text‘不是空字符串，它會驗證alert上的信息是否與‘text‘一致。
當然，如果alert不存在，測試將會失敗。注意，除非通過這個關鍵字或者別的關鍵字像‘Get Alert Message‘消除alert，否則后面執行的關鍵字會失敗。

3.Assign ID [ locator | id ]
分配一個臨時的標識符給一個元素，首先通過‘locator‘來定位這個元素。
當定位該元素的Xpath表達式很復雜時，這種方法非常有用。此外，當頁面重新載入時，這個標識符就到期了。

4.Capture Page Screenshot [ filename=None ]
在當前頁面上截屏，并把它放在日志里。
‘filename‘參數指定了一個元素的名稱并把截屏寫入。如果沒有提供‘filename‘，截屏將會被保存在‘selenium-screenshot-<counter>.png‘文件中，該文件就在RF日志文件被寫入的目錄下。‘css‘可以被用來改變截屏的執行方式。當頁面布局以某種方法被破壞時，可通過改變默認的背景顏色去避免可能的背景泄露問題。

5.Checkbox Should Be Selected [ locator ]
驗證‘locator‘標識的checkbox是否被選定。

6.Checkbox Should Not Be Selected [ locator ]
驗證‘locator‘標識的checkbox沒有被選定。

7.Choose Cancel On Next Confirmation [ ]
下次‘Confirm Action‘被使用時，撤銷將會被選定。

8.Choose File [ locator | file_path ]
將‘file_path‘寫入被標識的文件寫入區域。
這個關鍵字被經常使用去將文件寫入到上傳表格中。由‘file_path‘指定的文件必須存在于Selenium Server 運行的主機上。

9.Choose Ok On Next Confirmation [ ]
取消使用‘Choose Cancel on Next Confirmation‘這個關鍵字的影響。注意，Selenium的重寫window.confirm()函數通常會自動返回true，就好似用戶手動的點擊OK，所以你應該不需要這個命令，除非你需要改變你的next confirmation的首選項因為某些原因。在任一confirmation之后，Selenium將會為未來的confirmatons恢復使用默認值，自動的返回true(OK)除非你明確的對每一個confirmation使用‘Choose Cancel On Next Confirmation‘。
還要注意每次一個confirmation開始時，你必須使用‘Get Alert Mseeage‘等類似的關鍵字，不然selenium接下來的操作將會失敗。

10.Click Button [ locator ]
點擊被‘locator‘標識的按鈕。

11.Click Element [ ]
點擊被‘locator‘標識的元素。

12.Click Element At Coordinates [ ]
點擊被‘locator‘標識的元素，以該元素的x/y坐標為基準。鼠標移動到該元素的中心，x/y坐標就從那一點被計算出來。

13.Click Image [ ]
點擊被‘locator‘標識的圖片。

14.Click Link [ ]
點擊被‘locator‘標識的鏈接。

15.Close All Browsers [ ]
關掉所有打開的瀏覽器，并且重置這些瀏覽器的緩存。
這個關鍵字被執行之后，從‘Open Browser‘關鍵字返回的新的索引被重置為1。
這個關鍵字應該被用在test或者suite的teardown中，以確保所有瀏覽器被關閉。

16.Close Browser [ ]
關閉當前運行的瀏覽器。

17.Close Window [ ]
關閉當前彈出的窗口。

18.Confirm Action [ ]
關閉當前顯示的會話并返回它的信息。
這個關鍵字會默認選擇會話中的‘OK‘。如果需要選擇‘Cancel’，關鍵字‘Choose Cancel On Next Confirmation‘必須在引起確認會話被顯示的行為之前被調用。

例子：
Click Button Send # Shows a confirmation dialog
${message}= Confirm Action # Chooses Ok
Should Be Equal ${message} Are your sure?
Choose Cancel On Next Confirmation
Click Button Send # Shows a confirmation dialog
Confirm Action # Chooses Cancel

19.Current Frame Contains [text|loglevel=INFO]
核實當前frame是否包含‘text‘。

20.Current Frame Should Not Contain [text|loglevel=INFO]
核實當前frame是否包含‘text‘。

21.Delete All Cookies []
刪除所有cookies。

22.Delete Cookie [name]
刪除匹配‘name‘的cookie。如果這個cookie沒有被發現，什么事都不會發生。

23.Double Click Element [locator]
雙擊被‘locator‘標識的元素。

24.Drag And Drop [source|target]
拖拽被‘source‘ (實際是一個‘locator‘)定位的元素。
元素可被移動到其它目標元素之上。
‘target‘是一個元素定位器，指定了拖拽住的元素松開的位置。

25.Drop And Drop By Offset [source|xoffset|yoffset]
拖拽被‘source‘ (實際是一個‘locator‘)定位的元素。
元素將會被移動到坐標xoffset和yoffset指定的位置。坐標可以是正數也可是負數。

26.Element Should Be Disabled [locator]
驗證被‘locator‘指定的元素是否可用。

27.Element Should Be Enabled [locator]
驗證被‘locator‘指定的元素是否可用。

28.Element Should Be Visible []
驗證被‘locator‘指定的元素是否可見。
這里，可見指的是邏輯可見，而不是在當前瀏覽器窗口上的視覺可見。舉個例子，一個元素呈現為none,那么該元素就是邏輯上不可見的，所以在這個元素上使用此關鍵字將會失敗。

29.Element Should Contain [loactor|expected|message=]
驗證被‘locator‘定位的元素是否包含文本‘expected‘。
如果你想要在元素的文本里斷言一個精確的匹配而不是一個子串，使用關鍵字‘Element Text Should Be‘。
‘message‘可被用于覆蓋默認的錯誤信息。

30.Element Should Not Be Visible [locator|message=]
驗證被‘locator‘定位的元素是不可見的。
是關鍵字‘Element Should Be Visible‘的反義。
‘message‘可被用于覆蓋默認的錯誤信息。

31.Element Text Should Be [locator|expected|message=]
驗證被‘locator‘定位的元素是否精確的包含文本‘expected‘。
與‘Element Should Contain‘形成對比，這個關鍵字不是在被‘locator‘標識的元素上嘗試子串匹配，而是精確匹配。

32.Execute Async Javascript [*code]
執行異步JS代碼。
‘code‘可能含有很多行代碼，但是最后必須包含一個返回狀態（即要有返回值）。
‘code‘也許在測試數據中被分成很多單元。即便如此，彼此關聯的部分不允許增加任何空間。
如果‘code‘是一個指向一個存在的文件的完整的路徑，JS將從這個文件中讀取并執行。分隔號‘/‘用于所有操作系統的路徑分隔。
注意，默認地，代碼將會在Selenium對象自己的環境中執行。所以，‘this‘將會適用于the Selenium 對象。使用‘window‘去適用于你的應用的窗口。例如，‘window.document.getElementById(‘foo‘)‘.

33.Execute Javascript [*code]
執行提供的js代碼。
同關鍵字32。

34.Focus [locator]
設置被‘locator‘定位的元素為焦點。

35.Frame Should Contain [locator|text|loglevel=INFO]
驗證被‘locator‘定位的‘frame‘是否包含‘text‘。

36.Get Alert Message []
返回當前js alert里的內容。
如果當前沒有alert，這個關鍵字將會失敗。注意，接下來的關鍵字將會失敗除非alert通過這個關鍵字或者‘Get Alert Message‘被消除。

37.Get All Links []
返回一個列表，該列表包含當前頁面所有鏈接的id。
如果一個鏈接沒有id，這個列表將含有一個空的字符串。

38.Get Cookie Value [name]
返回名稱為‘name‘的cookie的值。
如果沒有cookie叫‘name‘，這個關鍵字失敗。

39.Get cookies []
返回當前頁面的所有cookie。

40.Get Element Attribute [attribute_locator]
返回元素屬性的值。
[email protected]?成，如"element_id@class"

41.Get Horizontal Position [locator]
返回被‘locator‘定位的元素的水平位置。
位置作為正數類型被返回到頁面左側的像素位置。如果沒有找到匹配的元素，將會失敗。

42.Get List Items [locator]
從已被‘locator‘定位select list中返回值。
Select list 關鍵字工作在每個列表和組合框中。select list的關鍵屬性是‘id‘和‘name‘。

43.Get Location []
返回當前的位置。

44.Get Matching Xpath Count [xpath]
返回匹配‘xpath‘的若干元素。
如果你想斷言若干匹配的元素，使用‘Xpath Should Match X Times‘.

45.Get Selected List Label [locator]
從被‘locator‘定位的select list中返回可見的選項元素的標簽。
Select list 關鍵字工作在每個列表和組合框中。select list的關鍵屬性是‘id‘和‘name‘。

46.Get Selected List Labels [locator]
從被‘locator‘定位的select list中返回可見的選項元素的標簽（作為一個列表）。
如果沒有選項將會失敗。

47.Get Selected List Value [locator]
從被‘locator‘標識的的select list中返回選中的元素的值。
返回值被選中的元素的‘value‘屬性讀取。
Select list 關鍵字工作在每個列表和組合框中。select list的關鍵屬性是‘id‘和‘name‘。

48.Get Selected List Values [locator]
從被‘locator‘標識的的select list中返回選中的元素的值(作為一個列表)。
返回值被選中的元素的‘value‘屬性讀取。
Select list 關鍵字工作在每個列表和組合框中。select list的關鍵屬性是‘id‘和‘name‘。

49.Get Selenium Implicit Wait []
獲取Selenium隱式等待時間。

50.Get Selenium Speed []
獲取每一條執行Selenium命令時的延遲等待時間。

51.Get Selenium Timeout []
在短時間內獲取timeout，被不同的關鍵字使用。

52.Get Source []
從當前頁面或框架返回整個html源。