robotframework Selenium2Library库

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源。