在robotframework当中，要实现web自动化，则需要使用SeleniumLibrary这个库。

目前版本中，有180+关键字。随着版本的更新，关键字的个数和名字也会有所变动。

在网上没有找到较为全面的关于这个库的关键字介绍，所以此篇文章作为一个汇总，列举常用的关键字。

1、SeleniumLibrary的安装：

前提：已安装好python环境并配置好环境变量。然后在命令行当中，运行以下命令：

pip install --upgrade robotframework-seleniumlibrary

 2、SeleniumLibrary结构、和Selenium的关系
 
SeleniumLibrary是一个python第三方库(存放在python安装目录下的Lib/site-packages/SeleniumLibrary)。它的结构如下，其中keywords目录下存放的是关键字。
 
在源码中，是分门别类的来存放关键字。包括alert弹框、表格/select/iframe等元素操作、等待、窗口等。
 
 SeleniumLibrary的源代码中，很多地方都直接使用了selenium的API来封装网页的操作，可以说是在selenium之上，封装了更多的元素操作关键字，提供给robot框架的使用者。毕竟有现成的“轮子”，就没有必要再重新造了。
 
比如上图中elment.py当中的鼠标操作。在selenium当中，ActionChains类是用来专门实现鼠标操作的。
 
以元素双击操作为例，如果使用python+selenium库来实现双击操作，需要以下代码：
 

 在SeleniumLibrary当中，关键字double click element 就将元素和鼠标双击操作封装在一起。只要传入元素定位即可(如下图所示)。
 
 3、SeleniumLibrary关键字分类解读
 
引入SeleniunLibrary库时，初始化参数
 
SeleniumLibrary在robotframework当中，引入时会将SeleniumLibrary这个类初始化。
 
初始化的参数是对所有关键字生效的。
 
 Timeout：等待超时时间。关键字当中有timeout参数的，都使用此处的默认值，5秒。
 
Implicit wait: 隐性等待时长。0.0表示没有隐性等待。
 
run on failure: 关键字运行失败时的动作。Capture Page Screenshot是截取页面图片的关键字。表示运行失败时，自动截取当前网页图片， 即失败时自动截图功能。
 
Screenshot root directory: 截取的网页图片存放路径 。None表示不指定路径 ，默认与输出文件同目录。
 
我们在robot当中引入SeleniumLibrary时，可以修改默认参数值。比如修改默认timeout为15s
 

 2）元素定位语法：
 
在web自动化当中，有8大定位方式。无论用什么样的语言/框架，定位方式都是通用的。
 
在robot框架当中，定位语法有以下2种表达方式：
 
 
定位策略:定位表达式(比如 id:kw)
 
 
定位策略=定位表达式(比如 id=kw)
 
 
在robot当中，除了8大定位方式以外，还额外扩展了几种，整体的定位方式如下(摘抄自官方文档)：
 
定位策略
匹配方式
定位示例
id
元素的id属性
id:example
name
元素的name属性
name:example
identifier
元素的id或者name属性
identifier:example
class
元素的class属性
class:example
tag
元素的标签名称
tag:div
xpath
xpath定位表达式
xpath://div[@id=“example”]
css
css selector定位表达式
css:div#example
dom
DOM表达式
dom:document.images[5]
link
精确匹配链接元素的文本内容
link:The example
partial link
部分匹配链接元素的文本内容
partial link:he ex
jquery
jQuery表达式
jquery:div.example
Click Element
id:foo
# 点击id为foo的元素。
Click Element
css:div#foo h1
# 点击 id为foo的div元素后代当中的h1元素
Click Element
xpath=//div[@id=“foo”]//h1
# 同上一个。
Click Element
//*[contains(text(), “example”)]
# 点击 文本内容包含example的元素
注意：xpath定位表达式可省略前缀：xpath。
 
3）浏览器和窗口操作关键字
 
关键字名称
关键字说明
open browser
打开浏览器并访问系统地址。url:网站地址,browser:浏览器类型
close browser
关闭浏览器
maximize browser window
当前窗口最大化
get window size
获取当前窗口的大小
set window size
设置窗口大小
get window handles
获取浏览器中，所有窗口的句柄
switch window
切换窗口。可根据窗口的句柄、标题、名称等切换
get window names
获取浏览器，所有窗口的名称
get window titles
获取所有窗口的标题
get locations
获取所有窗口的url
4）元素通用操作关键字(包含鼠标/键盘操作)：
 
关键字名称
关键字说明
click ement
点击元素
input text
在元素中输入文本值
get element attribute
获取元素的某一个属性值
get element size
获取元素的大小
get value
获取元素的value属性值
get text
获取元素的文本内容
clear element text
清除元素的文本值
get webelement
获取一个元素对象。WebElment对象。
get webelements
获取匹配的所有元素对象。WebElment对象
set focus to element
元素获取焦点
double click element
双击元素
scroll element into view
滚动元素到可见区域
drag and drop
将一个元素拖拽到另一个元素区域中
mouse over
鼠标悬浮在元素上
press keys
键盘按键操作
5）select/frame/alert/表格等操作关键字：
 
关键字名称
关键字说明
get list items
select/option元素中，获取所有的options选项
select from list by index
select/option元素中，根据下标来选择option选项
select from list by value
select/option元素中，根据value属性来选择option选项
select from list by label
select/option元素中，根据文本内容来选择option选项
select frame
切换到指定的iframe当中
unselect frame
退出iframe，切换到默认的html页面中
handle alert
关闭alert弹出框
input text into alert
输入文本到alert弹框中，并关闭alert弹出框
choose file
在上传文件的输入框中(input元素的type为file)输入文本地址
get table cell
获取表格的单元格值。行号和列号起始值为1.包含表头和表尾所对应的行
6）元素等待关键字
 (关键字中包含wait的, timeout参数默认为seleniumlibrary初始化值，默认为5秒)：
 
关键字名称
关键字说明
wait for condition
等待条件成立：条件为js表达式，表达式的结果要为布尔值。
wait until element is visible
等待指定的元素可见
wait until element is not visible
等待指定的元素不可见
wait until element is enabled
等待指定的元素可用
wait until element contains
等待指定的元素 包含 指定的文本内容
wait until element does not contain
等待指定的元素 不包含 指定的文本内容
wait until page contains element
等待页面 包含指定的元素
wait until page contains element
等待页面 不包含指定的元素
wait until page contains
等待页面 包含指定的文本内容
wait until page does not contain
等待页面 不包含指定的文本内容
7）断言关键字(关键字中包含should的均是)：
 
关键字名称
关键字说明
page should contain element
页面应当 包含指定的元素
page should not contain element
页面应当 不包含指定的元素
locator should match x times
元素定位表达式应该匹配 指定 次数
element should be visible
指定的元素 应当可见
element should not be visible
指定的元素 应当不可见
element should be enabled
指定的元素 应当可用
element should be disabled
指定的元素 应当不可用
element text should be
指定元素的文本内容 应当是 指定内容
element text should not be
指定元素的文本内容 应当不是 指定内容
element should be focused
指定的元素 应当为焦点状态
还有很多其它断言的关键字，不一一列举。
 
8）截屏类关键字：
 
关键字名称
关键字说明
capture page screenshot
截取当前页面图片。
capture element screenshot
截取指定元素的图片。
set screenshot directory
设置截图存储目录。
4、robot - web自动化使用示例
 
 如果对软件测试、接口测试、自动化测试、面试经验交流感兴趣可以加入我们。642830685，免费领取最新软件测试大厂面试资料和Python自动化、接口、框架搭建学习资料！技术大牛解惑答疑，同行一起交流。
 
 
 
                    在robotframework当中，要实现web自动化，则需要使用SeleniumLibrary这个库。目前版本中，有180+关键字。随着版本的更新，关键字的个数和名字也会有所变动。在网上没有找到较为全面的关于这个库的关键字介绍，所以此篇文章作为一个汇总，列举常用的关键字。1、SeleniumLibrary的安装：前提：已安装好python环境并配置好环境变量。然后在命令行当中，运行以下命令：pip install --upgrade robotframework-seleniumlibrary
selenium-3.8.0.tar.gz
robotframework-seleniumlibrary
robotframework-seleniumlibrary-3.2.0.tar.gz
SeleniumLibrary
*** Settings ***
Documentation     Simple example ...
				
什么是selenium
Selenium 自动化测试工具，它主要是用于 Web 应用程序的自动化测试，但并不只局限于此，同时支持所有基于 web 的管理任务自动化。
Selenium 的特点：
1.开源，免费
2.多浏览器支持：FireFox、Chrome、IE、Opera
3.多平台支持：linux 、windows、MAC
4.多语言支持：java、Python、Ruby、php、C#、Jav...
				
一、安装robotframework-seleniumlibrary
GitHub - robotframework/SeleniumLibrary: Web testing library for Robot Framework
(env)$ pip install --upgrade robotframework-seleniumlibrary
robotframework-seleniumlibrary-4.5.0 robotframework-selenium2library-3.0.
SeleniumLibrary是Robot Framework的Web测试库。
本文档说明了如何使用SeleniumLibrary提供的关键字。 有关安装，支持等信息，请参见python3.9.0 + robotframework + selenium3 实例体验。
有关robotframework框架的更多信息，请参见https://blog.csdn.net/mask57..
SeleniumLibrary是Robot Framework的Web测试库。
本文档说明了如何使用SeleniumLibrary提供的关键字。 有关安装，支持等信息，请参见 python3.9.0 + robotframework + selenium3 实例体验。
有关robotframework框架的更多信息，请参见 https://blog.csdn.net/mask5
				
Robotframework是一个基于关键字测试驱动的框架，它能够基于一定的规则，导入你需要的测试库（例如seleniumlibrary，databaselibrary），然后基于这些测试库，编写自己的关键字，之后，编写测试用例进行测试。关键字颗粒大小可以自己进行定制。
本文记录了使用seleniumlibrary测试库遇见的一些问题以及解决办法。
1、定位动态出现且无法通过鼠标操作的元素
可以使用键盘操作：
先按F12,页面切换到Sources，按下F8进行断点调试，然后页面切到Elements会话框，可
				
（一）自定义和浏览器相关的关键字
PYTHON 版本：3.6，不同的版本可能有区别，自己注意下。
SeleniumLibrary的扩展文档中提供了3种增加SeleniumLibrary功能的方式。
（1）Plugin API
（2）EventFiringWebDriver
（3）Extending SeleniumLibrary（实际就是继承SeleniumLibrary库）
这里采用继承SeleniumLibrary库的方式。
目录结构如下：这里我们将上一篇中说到的关键字加进来
BlogSelenium
SeleniumLibrary是Robot Framework的Web测试库。
本文档说明了如何使用SeleniumLibrary提供的关键字。 有关安装，支持等信息，请参见 python3.9.0 + robotframework + selenium3 实例体验。
有关robotframework框架的更多信息，请参见 https://blog.csdn.net/mask5726/cat