SeleniumLibrary 主要关键字 基于python3

关键字的解释

https://blog.csdn.net/ak739105231/article/details/88926995

click element	都是元素点击事件；不赘述
click link
click image

click button

点击按钮

get value	获取页面元素的value或text,若没有text就获取空值
get text

get element attribute

获取元素属性；举例：要获取class值，则：get element attribute element_id@class

mouse down	鼠标操作、笔者推荐使用AutoItLibrary模块下的鼠标操作
mouse up
mouse over
mouse out

Open Browser	打开浏览器
Close Browser	关闭浏览器
Go to	访问某个URL
Go Back	相当于浏览器的后退

get window handles

获取当前线程所有window的handles

Select Window

切换要使用的Window

Close All Browsers

关闭所有浏览器

selectitems下拉列表：关键字-解释

get list items

获取选择列表框所有项

select from list by index	分别通过index/value/label来选择列表项
select from list by value
select from list by label

说明：Web页面里面最多出现的对象就是table了，使用最多的关键字就是get table  cell
tableElement	get table  cell	可以获取指定table里的指定行列的元素文本值

waiting
关键字类型	关键字	解释

Select Frame	选择frame或iframe，才可操作里面的元素;如frame/iframe层数多，也要一层层的选择进入
Unselect Frame	直接跳出所有的frame 或iframe;

元素操作

Click Element[ locater ]

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]

返回元素属性的值。

属性定位器'attribute_locator'由标识@和属性名称组成，如"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源

———————————————— 版权声明：本文为CSDN博主「风口的梅梅」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。 原文链接：https://blog.csdn.net/weixin_42180610/article/details/80269957