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，否則后面執(zhí)行的關鍵字會失敗怀伦。
3.Assign ID [ locator | id ]
分配一個臨時的標識符給一個元素脆烟，首先通過‘locator‘來定位這個元素。
當定位該元素的Xpath表達式很復雜時房待，這種方法非常有用邢羔。此外，當頁面重新載入時吴攒，這個標識符就到期了张抄。
4.Capture Page Screenshot [ filename=None ]
在當前頁面上截屏，并把它放在日志里洼怔。
‘filename‘參數(shù)指定了一個元素的名稱并把截屏寫入署惯。如果沒有提供‘filename‘，截屏將會被保存在‘selenium-screenshot-<counter>.png‘文件中镣隶，該文件就在RF日志文件被寫入的目錄下极谊。‘css‘可以被用來改變截屏的執(zhí)行方式安岂。當頁面布局以某種方法被破壞時轻猖，可通過改變默認的背景顏色去避免可能的背景泄露問題。
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‘寫入被標識的文件寫入?yún)^(qū)域败许。
這個關鍵字被經(jīng)常使用去將文件寫入到上傳表格中。由‘file_path‘指定的文件必須存在于Selenium Server 運行的主機上淑蔚。
9.Choose Ok On Next Confirmation [ ]
取消使用‘Choose Cancel on Next Confirmation‘這個關鍵字的影響市殷。注意，Selenium的重寫window.confirm()函數(shù)通常會自動返回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 [ ]
關掉所有打開的瀏覽器畔况，并且重置這些瀏覽器的緩存鲸鹦。
這個關鍵字被執(zhí)行之后，從‘Open Browser‘關鍵字返回的新的索引被重置為1跷跪。
這個關鍵字應該被用在test或者suite的teardown中馋嗜，以確保所有瀏覽器被關閉。
16.Close Browser [ ]
關閉當前運行的瀏覽器吵瞻。
17.Close Window [ ]
關閉當前彈出的窗口葛菇。
18.Confirm Action [ ]
關閉當前顯示的會話并返回它的信息。
這個關鍵字會默認選擇會話中的‘OK‘橡羞。如果需要選擇‘Cancel’眯停，關鍵字‘Choose Cancel On Next Confirmation‘必須在引起確認會話被顯示的行為之前被調(diào)用。
例子：
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沒有被發(fā)現(xiàn)齐邦，什么事都不會發(fā)生。
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指定的位置璧诵。坐標可以是正數(shù)也可是負數(shù)汰蜘。
26.Element Should Be Disabled [locator]
驗證被‘locator‘指定的元素是否可用。
27.Element Should Be Enabled [locator]
驗證被‘locator‘指定的元素是否可用之宿。
28.Element Should Be Visible []
驗證被‘locator‘指定的元素是否可見族操。
這里，可見指的是邏輯可見，而不是在當前瀏覽器窗口上的視覺可見色难。舉個例子泼舱，一個元素呈現(xiàn)為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]
執(zhí)行異步JS代碼苍凛。
‘code‘可能含有很多行代碼氧急，但是最后必須包含一個返回狀態(tài)（即要有返回值）。
‘code‘也許在測試數(shù)據(jù)中被分成很多單元毫深。即便如此吩坝，彼此關聯(lián)的部分不允許增加任何空間。
如果‘code‘是一個指向一個存在的文件的完整的路徑哑蔫，JS將從這個文件中讀取并執(zhí)行钉寝。分隔號‘/‘用于所有操作系統(tǒng)的路徑分隔。
注意闸迷，默認地嵌纲，代碼將會在Selenium對象自己的環(huán)境中執(zhí)行。所以腥沽，‘this‘將會適用于the Selenium 對象逮走。使用‘window‘去適用于你的應用的窗口。例如今阳，‘window.document.getElementById(‘foo‘)‘.
33.Execute Javascript [*code]
執(zhí)行提供的js代碼师溅。
同關鍵字32。
34.Focus [locator]
設置被‘locator‘定位的元素為焦點盾舌。
35.Frame Should Contain [locator|text|loglevel=INFO]
驗證被‘locator‘定位的‘frame‘是否包含‘text‘墓臭。
36.Get Alert Message []
返回當前js alert里的內(nèi)容。
如果當前沒有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‘定位的元素的水平位置。
位置作為正數(shù)類型被返回到頁面左側的像素位置琉闪。如果沒有找到匹配的元素迹炼，將會失敗。
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 []
獲取每一條執(zhí)行Selenium命令時的延遲等待時間。
51.Get Selenium Timeout []
在短時間內(nèi)獲取timeout创译，被不同的關鍵字使用抵知。
52.Get Source []
從當前頁面或框架返回整個html源。
