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
