正文
robot_framewok自动化测试--（8）SeleniumLibrary 库（selenium、元素定位、关键字和分层设计）
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
SeleniumLibrary 库一、selenium1.1、Selenium 介绍
Selenium 自动化测试工具，它主要是用于 Web 应用程序的自动化测试，但并不只局限于此，同时支持所有基于 web 的管理任务自动化。Selenium 的特点：- 开源，免费
- 多浏览器支持：FireFox、Chrome、IE、Opera
- 多平台支持：linux 、windows、MAC
- 多语言支持：java、Python、Ruby、php、C#、JavaScript
- 对 web 页面有良好的支持
- 简单（API 简单）、灵活（用开发语言驱动）
- 支持分布式测试用例执行
Selenium 是支持多种开发语言的，对于不同的语言来说都有其对应的库。2.2、安装 SeleniumLibrary
>pip install robotframework-seleniumlibrary
在前面内容中已经知道了如何添加库，现在我们将“SeleniumLibrary”库添加到相应的测试套件中。
添加完成，黑色示添加的库正常，红色表示库不存。如果为红色，请检查site-packages 目录下是否有 Selenium2Library 目录1.3第一个例子
我们已经有了学习 Robot Framework 的经验，通过按 F5 快捷键来查询库所提供的关键字。
如上图，自动化脚本从打开浏览器开如，我想打开一个浏览器，自然想到的是以“open”为关键字进行搜索，结果找到了一个“Open Browser”的关键字，点击这个关键字，显示它的用法和说明。
根据说明，我们来尝试创建这个打开浏览器的操作吧，这里跟新着我们写一个 web 自动化测试用例（百度搜索用例）：
执行结果：
Starting test: Test Project.Test Suit.baidu_search
20211107 22:53:51.920 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211107 22:53:51.921 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE0vzfcxc0.d\geckodriver-3.log
20211107 22:54:00.407 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211107 22:54:00.632 : INFO : Clicking button 'id=su'.
20211107 22:54:05.906 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
二、元素定位对于 Web 自动化测试来说，就是操作页面上的各种元素，在操作元素之间需要先找到元素，换句话说就是定位元素。SeleniumLibrary 提供了非常丰富的定位器：
虽提供了这么多种定位方式，并不是要求我们每一种都要学会。在这里我只介绍 4 种定位方式，id、name、xpath 和 css。介绍 id 和 name，是因为这两种定位方式非常简单且实用，介绍 xpath 和 css，是因为这两种定位方式足够强大，可以满足几乎所有定位需求。
2.1 前端工具
在学习定位之前，有必要先介绍一下浏览器的前端具。firefox 浏览器可以通过 firebug 工具查查看页面元素。
2.2 id 和 name 定位
假如把一个元素看作一个人的话，id 和 name 可以看作一个人的身份证号和姓名。当然，这些属性值是否唯一要看前端工程师如何设计了。
根据上面的例子，百度输入框可以取 id 或 name 进行定位。（前提是 id 和 name 的值在当页面上唯一）id = kw1name = wd在 Robot framework 中就是这样写的：
Input text 用于输入框的关键字，“robot framework 学习”是要给输入框输入的内容。
百度按钮只 id 数据可以利用：id=su
Click Button 是按钮点击的关键字。
2.3 xpath 定位
XPath 是一种在 XML 文档中定位元素的语言。因为 HTML 可以看做 XML 的一种实现，所以 selenium用户可是使用这种强大语言在 web 应用中定位元素。假如，一个人没身份证号没名字怎么找呢？想想你是怎么找朋友吃饭的，他手机不通，电话不回呢？直接上他家去呗，那你一定有他家住址，xx 市 xx 区 xx 路 xx 号。xpath 就可以通过这种层级关系找到元素。（1）xpath 的绝对路径：
xpath = /html/body/div[1]/div[4]/div[2]/div/form/span[1]/input
我们可以从最外层开始找，html 下面的 body 下面的 div 下面的第 4 个 div 下面的....input 标签。通过一级一级的锁定就找到了想要的元素。（2）xpath 的相对路径：
绝对路径的用法往往是在我们迫不得已的时候才用的。大多时候用相对路径更简便。- 元素本身：
Xpath 同样可以利用元素自身的属性：Xpath = //*[@id=’kw1’]//表示某个层级下，*表示某个标签名。@id=kw1 表示这个元素有个 id 等于 kw1 。当然，一般也可以制定标签名：Xpath = //input[@id=’kw1’]元素本身，可以利用的属性就不只局限为于 id 和 name ，如：Xpath = //input[@type=’text’]Xpath = //input[@autocomplete=’off’]但要保证这些元素可以唯一的识别一个元素。- 找上级：
当我们要找的一个人是个刚出生的婴儿，还没起名子也没有入户口（身份证号），但是你会永远跟在你父亲的身边，你的父亲是有唯一的名字和身份证号的，这样我们可以先找到你父亲，自然就找到你的。元素的上级属性为：<form id="form1" class="fm" action="/s" name="f1">
<span class="bg s_ipt_wr">
<input id="kw1" class="s_ipt" type="text" maxlength="100" name="wd" utocomplete="off">
找爸爸：xpath = //span[@class=’bg s_ipt_w’]/input如果爸爸没有唯一的属性，可以找爷爷：xpath = //form[@id=’form1’]/span/input这样一级一级找上去，直到 html ，那么就是一个绝对路径了。- 布尔值写法：
如果一个人的姓名不是唯一的，身份证号也不是唯一的，但是同时叫张三 并且 身份证号为 123 的人却可以唯一的确定一个人。那么可以这样写：Xpath = //input[@id=’kw1’ and @name=’wd’]可以 and ，当然也可以 or :Xpath = //input[@id=’kw1’ or @name=’wd’]但 or 的实际意义不太。我们一般不需要说，找的人名字或者叫张三，或者身份证号是 123 也可以Robot framework 中的写法：
2.4 css 定位
CSS(Cascading Style Sheets)是一种语言，它被用来描述 HTML 和 XML 文档的表现。CSS 使用选择器来为页面元素绑定属性。这些选择器可以被 selenium 用作另外的定位策略。CSS 可以比较灵活选择控件的任意属性，一般情况下定位速度要比 XPath 快，但对于初学者来说比较难以学习使用，下面我们就详细的介绍 CSS 的语法与使用。CSS 选择器的常见语法：
- 通过 class 属性定位：
css=.s_iptcss=.bg s_btncsscss_selector()方法用于 CSS 语言定位元素，点号（.）表示通过 class 属性来定位元素。- 通过 id 属性定位：
css=#kwcss=#su井号（#）表示通过 id 属性来定位元素。- 通过标签名定位：
css=input在 CSS 语言中用标签名定位元素不需要任何符号标识，直接使用标签名即可，但我们前面已经了解到标签名重复的概率非常大，所以通过这种方式很难唯一的标识一个元素。 - 通过父子关系定位：
css=span>input上面的写法表示有父亲元素，它的标签名叫 span，查找它的所有标签名叫 input 的子元素。- 通过属性定位：
css=input[autocomplete='off']css=input[maxlength='100']css=input[type='submit']在 CSS 当中也可以使用元素的任意属性，只要这些属性可以唯一的标识这个元素。- 组合定位：
我们当然可以把上面的定位策略组合起来使用，这样就大大加强了元素的唯一性。css=span.bg s_ipt_wr>input.s_iptcss=span.bg s_btn_wr>input#su有一个父元素，它的标签名叫 span，它有一个 class 属性值叫 bg s_ipt_wr，它有一个子元素，标签名叫 input，并且这个子元素的 class 属性值叫 s_ipt。好吧！我们要找的就是具有这么多特征的一个子元素。Robot framework 中的写法：
三、SeleniumLibrary 关键字关于 Selenium2Library 的关键字，我们可以参考通过 F5查找 Selenium2Library 关键字库：
3.1浏览器驱动
通过不同的浏览器执行脚
浏览器对应的关键字：
open browser 同样也可以打开本地 html 页面，如：
备注：
- 要想通过不同的浏览打开 URL 地址，一定要安装浏览器相对应的驱动。
- chrome 的驱动为：chromedriver.exe 。
- IE 的驱动为：IEDriverServer.exe
- 浏览器默认为空时启动 FireFox。
3.2 关闭浏览器
close browser 关闭当前的浏览器。close all browser 关键所有打开的浏览器和缓存重置3.3 浏览器最大化
Maximize Browser Window 关键字使当前打开的浏览器全屏。
3.4 设置浏览器窗口宽、高
get windows size 关键字用于打设置打开浏览器的宽度和高度。以像素为单位，第一个参数 800 表示宽度，第二个参数 600 表示高度
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 13:51:33.456 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 13:51:33.457 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-2.log
20211108 13:51:41.610 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 13:51:42.123 : INFO : Clicking button 'id=su'.
20211108 13:51:42.465 : INFO : ${width} = 1295
20211108 13:51:42.465 : INFO : ${height} = 695
20211108 13:51:42.466 : INFO : 1295
20211108 13:51:42.467 : INFO : 695
20211108 13:51:47.474 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.5 文本输入
input text 关键字用于向文本框内输入内容。
xpath=//* [@] ：表示元素定位，定位文本输入框。
3.6 点击元素
Click Element 关键字用于点击页面上的元素，单击任何可以点击按钮、文字/图片连接、复选框、单选框、甚至是下拉框等。xpath=//* [@] ：表示元素定位，定位点击的元素。
3.7 点击按钮
Click Button关键字用于点击页面上的按钮。
Xpath=//* [@] ：表示元素定位，定位点击的按钮。
3.8 等待元素出现
Wait Until Page Contains Element 关键字用于等待页面上的元素显示出来。Xpath=//* [@] ：表示元素定位，这里定位出现的元素42 ： 表示最长等待时间。Error ： 表示错误提示，自定义错误提示，如：“元素不能正常显示” 
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:00:30.027 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:00:30.028 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-3.log
20211108 14:00:38.176 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:00:38.519 : INFO : Clicking button 'id=su'.
20211108 14:00:38.867 : INFO : ${width} = 1295
20211108 14:00:38.867 : INFO : ${height} = 695
20211108 14:00:38.868 : INFO : 1295
20211108 14:00:38.869 : INFO : 695
20211108 14:00:43.879 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.9 获取title
get title 关键字用于获得当前浏览器窗口的 title 信息。这里只获取 title 是没有意义的，我们通常会将获取的 title 传递给一个变量，然后与预期结果进行比较。从而判断当前脚本执行成功。
执行结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:22:12.707 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:22:12.710 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-9.log
20211108 14:22:20.330 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:22:20.718 : INFO : Clicking button 'id=su'.
20211108 14:22:21.052 : INFO : ${a} = 百度一下，你就知道
20211108 14:22:21.053 : INFO : 百度一下，你就知道
20211108 14:22:21.055 : INFO : ${width} = 1295
20211108 14:22:21.056 : INFO : ${height} = 695
20211108 14:22:21.056 : INFO : 1295
20211108 14:22:21.057 : INFO : 695
20211108 14:22:26.065 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.10 获取text
get text 关键字用于获取元素的文本信息。xpath=//* [@] ： 定位文本信息的元素。
3.11 获取元素属性值
id=kw@name：id=kw 表示定位的元素。@nam 获取这个元素的 name 属性值。
3.12 cookei 处理
- get cookies 获得当前浏览器的所有 cookie 。
- get cookie value 获得 cookie 值。key_name 表示一对 cookie 中 key 的 name 。
- add cookie 添加 cookie。添加一对 cooke （key：value）
- delete cookie 删除 cookie。删除 key 为 name 的 cookie 信息。
- delete all cookies 删除当前浏览器的所有 cookies。
3.13 验证
获得浏览器 title 进行比较。
- Open Browser 通过 chrome 打开百度首页。
- Get Title 获得浏览器窗口的 titile ，并赋值给变量${title}
- Should Contain 比较${title}是否等于“百度一下，你就知道”。
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:52:20.175 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:52:20.176 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-11.log
20211108 14:52:27.393 : INFO : ${title} = 百度一下，你就知道
20211108 14:52:27.426 : INFO : Typing text 'robotframework学习' into text field 'id=kw'.
20211108 14:52:27.842 : INFO : Clicking button 'id=su'.
20211108 14:52:29.741 : INFO : ${a} = robotframework学习_百度搜索
20211108 14:52:29.742 : INFO : robotframework学习_百度搜索
20211108 14:52:29.745 : INFO : ${width} = 1295
20211108 14:52:29.745 : INFO : ${height} = 695
20211108 14:52:29.746 : INFO : 1295
20211108 14:52:29.747 : INFO : 695
20211108 14:52:31.760 : INFO : Slept 2 seconds
Ending test: Test Project.Test Suit.baidu_search
获得文本信息进行比较
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 15:17:03.377 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 15:17:03.379 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-17.log
20211108 15:17:10.732 : INFO : ${title} = 百度一下，你就知道
20211108 15:17:10.754 : INFO : Typing text 'robotframework学习' into text field 'id=kw'.
20211108 15:17:11.217 : INFO : Clicking button 'id=su'.
20211108 15:17:19.166 : INFO : Slept 5 seconds
20211108 15:17:19.189 : INFO : ${text} = 帮助
20211108 15:17:19.194 : INFO : ${width} = 1295
20211108 15:17:19.194 : INFO : ${height} = 695
20211108 15:17:19.195 : INFO : 1295
20211108 15:17:19.205 : INFO : 695
20211108 15:17:21.209 : INFO : Slept 2 seconds
Ending test: Test Project.Test Suit.baidu_search
3.14 表单嵌套
有时候和页面中会出现表单嵌套，这个时候需要进入到表单才能操作相关元素。
Select Frame 进入表单，Xpath=//* [@] 表示定位要进入的表单。
Unselect Frame 退出表单。3.15 下拉框选择
Unselect From List By Value 关键字用天选择下拉框。Xpath=//* [@] 定位下拉框；Vlaue 选择下拉框里的属性值。3.16 执行 JavaScript
在一些特殊的情况下需要调用 JavaScript 代码。
Execute Javascript 关键字用于使用 JavaScript 代码
四、Robot Framework 分层设计谈到 Robot Framework 分层的思想，就不得不提“关键字驱动”。回到分层的思想上，在程序设计的讲究设计模式，设计模式其实就是根据需求使用抽象与封装，其实就是分层思想。把一个实现过程分成不同多层。提高的灵活性，从而达到可扩展性和可维护性。再回到自动化的话题上，我们可以把操作步骤封装一个一个的方法（关键字），通过调用关键字来实现测试用例。参考前面创建的一条百度搜索的测试用例。1、创建资源
右键“测试项目”选择“new resource”创建资源。
2、创建关键字
右键“业务关键字”选择“new User Keyword” 来创建用户关键字
输入关键字的名称：
3、编辑关键字
分析：
对于一个测试用例来说，用户关心的是输入什么内容，得到什么结果。所以，对于“百度搜索”关键字来说，需要创建两个接口变量${search}和${result} 两个变量，用于接收输入内容和预期结果。点击 Arguments 输入框，定义变量，多个变量从用“|”隔开。 在百度用户中使用参数化变量。
4、添加创建的资源
切换到测试套件（Search）页面，添加资源（业务关键字.txt） 
5、调用关键字
现在就可以在测试用例中使用创建的关键字了（百度搜索）。
对于每一条用例来说，调用“百度搜索”关键字，输入搜索内容，输入预期结果即可。不同关心用例是如何执行的。如果百度输入框的定位发生了变化，只用去修改“百度搜索”关键字即可，不用对每一条用例做任何修改。大大提高的用例的维护性和扩展性。
继续分层的设计：
到此，Robot Framework +Selenium 自动化测试粗犷的讲完了。当然还有更多 API 的使用，和细枝末节的设置没有介绍。但我们已经可以拿它来开展自动化工作了。
1.1、Selenium 介绍
Selenium 自动化测试工具，它主要是用于 Web 应用程序的自动化测试，但并不只局限于此，同时支持所有基于 web 的管理任务自动化。
Selenium 的特点：
- 开源，免费
- 多浏览器支持：FireFox、Chrome、IE、Opera
- 多平台支持：linux 、windows、MAC
- 多语言支持：java、Python、Ruby、php、C#、JavaScript
- 对 web 页面有良好的支持
- 简单（API 简单）、灵活（用开发语言驱动）
- 支持分布式测试用例执行
Selenium 是支持多种开发语言的，对于不同的语言来说都有其对应的库。
2.2、安装 SeleniumLibrary
>pip install robotframework-seleniumlibrary
在前面内容中已经知道了如何添加库，现在我们将“SeleniumLibrary”库添加到相应的测试套件中。
添加完成，黑色示添加的库正常，红色表示库不存。如果为红色，请检查site-packages 目录下是否有 Selenium2Library 目录
1.3第一个例子
我们已经有了学习 Robot Framework 的经验，通过按 F5 快捷键来查询库所提供的关键字。
如上图，自动化脚本从打开浏览器开如，我想打开一个浏览器，自然想到的是以“open”为关键字进行搜索，结果找到了一个“Open Browser”的关键字，点击这个关键字，显示它的用法和说明。
根据说明，我们来尝试创建这个打开浏览器的操作吧，这里跟新着我们写一个 web 自动化测试用例（百度搜索用例）：
执行结果：
Starting test: Test Project.Test Suit.baidu_search
20211107 22:53:51.920 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211107 22:53:51.921 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE0vzfcxc0.d\geckodriver-3.log
20211107 22:54:00.407 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211107 22:54:00.632 : INFO : Clicking button 'id=su'.
20211107 22:54:05.906 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
二、元素定位对于 Web 自动化测试来说，就是操作页面上的各种元素，在操作元素之间需要先找到元素，换句话说就是定位元素。SeleniumLibrary 提供了非常丰富的定位器：虽提供了这么多种定位方式，并不是要求我们每一种都要学会。在这里我只介绍 4 种定位方式，id、name、xpath 和 css。介绍 id 和 name，是因为这两种定位方式非常简单且实用，介绍 xpath 和 css，是因为这两种定位方式足够强大，可以满足几乎所有定位需求。
2.1 前端工具
在学习定位之前，有必要先介绍一下浏览器的前端具。firefox 浏览器可以通过 firebug 工具查查看页面元素。2.2 id 和 name 定位
假如把一个元素看作一个人的话，id 和 name 可以看作一个人的身份证号和姓名。当然，这些属性值是否唯一要看前端工程师如何设计了。
根据上面的例子，百度输入框可以取 id 或 name 进行定位。（前提是 id 和 name 的值在当页面上唯一）id = kw1name = wd在 Robot framework 中就是这样写的：Input text 用于输入框的关键字，“robot framework 学习”是要给输入框输入的内容。
百度按钮只 id 数据可以利用：id=suClick Button 是按钮点击的关键字。
2.3 xpath 定位
XPath 是一种在 XML 文档中定位元素的语言。因为 HTML 可以看做 XML 的一种实现，所以 selenium用户可是使用这种强大语言在 web 应用中定位元素。假如，一个人没身份证号没名字怎么找呢？想想你是怎么找朋友吃饭的，他手机不通，电话不回呢？直接上他家去呗，那你一定有他家住址，xx 市 xx 区 xx 路 xx 号。xpath 就可以通过这种层级关系找到元素。（1）xpath 的绝对路径：
xpath = /html/body/div[1]/div[4]/div[2]/div/form/span[1]/input
我们可以从最外层开始找，html 下面的 body 下面的 div 下面的第 4 个 div 下面的....input 标签。通过一级一级的锁定就找到了想要的元素。（2）xpath 的相对路径：
绝对路径的用法往往是在我们迫不得已的时候才用的。大多时候用相对路径更简便。- 元素本身：
Xpath 同样可以利用元素自身的属性：Xpath = //*[@id=’kw1’]//表示某个层级下，*表示某个标签名。@id=kw1 表示这个元素有个 id 等于 kw1 。当然，一般也可以制定标签名：Xpath = //input[@id=’kw1’]元素本身，可以利用的属性就不只局限为于 id 和 name ，如：Xpath = //input[@type=’text’]Xpath = //input[@autocomplete=’off’]但要保证这些元素可以唯一的识别一个元素。- 找上级：
当我们要找的一个人是个刚出生的婴儿，还没起名子也没有入户口（身份证号），但是你会永远跟在你父亲的身边，你的父亲是有唯一的名字和身份证号的，这样我们可以先找到你父亲，自然就找到你的。元素的上级属性为：<form id="form1" class="fm" action="/s" name="f1">
<span class="bg s_ipt_wr">
<input id="kw1" class="s_ipt" type="text" maxlength="100" name="wd" utocomplete="off">
找爸爸：xpath = //span[@class=’bg s_ipt_w’]/input如果爸爸没有唯一的属性，可以找爷爷：xpath = //form[@id=’form1’]/span/input这样一级一级找上去，直到 html ，那么就是一个绝对路径了。- 布尔值写法：
如果一个人的姓名不是唯一的，身份证号也不是唯一的，但是同时叫张三 并且 身份证号为 123 的人却可以唯一的确定一个人。那么可以这样写：Xpath = //input[@id=’kw1’ and @name=’wd’]可以 and ，当然也可以 or :Xpath = //input[@id=’kw1’ or @name=’wd’]但 or 的实际意义不太。我们一般不需要说，找的人名字或者叫张三，或者身份证号是 123 也可以Robot framework 中的写法：
SeleniumLibrary 提供了非常丰富的定位器：
虽提供了这么多种定位方式，并不是要求我们每一种都要学会。在这里我只介绍 4 种定位方式，id、name、xpath 和 css。介绍 id 和 name，是因为这两种定位方式非常简单且实用，介绍 xpath 和 css，是因为这两种定位方式足够强大，可以满足几乎所有定位需求。
2.1 前端工具
在学习定位之前，有必要先介绍一下浏览器的前端具。
firefox 浏览器可以通过 firebug 工具查查看页面元素。
2.2 id 和 name 定位
假如把一个元素看作一个人的话，id 和 name 可以看作一个人的身份证号和姓名。当然，这些属性值是否唯一要看前端工程师如何设计了。
根据上面的例子，百度输入框可以取 id 或 name 进行定位。（前提是 id 和 name 的值在当页面上唯一）
id = kw1
name = wd
在 Robot framework 中就是这样写的：
Input text 用于输入框的关键字，“robot framework 学习”是要给输入框输入的内容。
百度按钮只 id 数据可以利用：
id=su
Click Button 是按钮点击的关键字。
2.3 xpath 定位
XPath 是一种在 XML 文档中定位元素的语言。因为 HTML 可以看做 XML 的一种实现，所以 selenium用户可是使用这种强大语言在 web 应用中定位元素。
假如，一个人没身份证号没名字怎么找呢？想想你是怎么找朋友吃饭的，他手机不通，电话不回呢？直接上他家去呗，那你一定有他家住址，xx 市 xx 区 xx 路 xx 号。xpath 就可以通过这种层级关系找到元素。
（1）xpath 的绝对路径：
xpath = /html/body/div[1]/div[4]/div[2]/div/form/span[1]/input
我们可以从最外层开始找，html 下面的 body 下面的 div 下面的第 4 个 div 下面的....input 标签。通过一级一级的锁定就找到了想要的元素。
（2）xpath 的相对路径：
绝对路径的用法往往是在我们迫不得已的时候才用的。大多时候用相对路径更简便。
- 元素本身：
Xpath 同样可以利用元素自身的属性：
Xpath = //*[@id=’kw1’]
//表示某个层级下，*表示某个标签名。@id=kw1 表示这个元素有个 id 等于 kw1 。
当然，一般也可以制定标签名：
Xpath = //input[@id=’kw1’]
元素本身，可以利用的属性就不只局限为于 id 和 name ，如：
Xpath = //input[@type=’text’]
Xpath = //input[@autocomplete=’off’]
但要保证这些元素可以唯一的识别一个元素。
- 找上级：
当我们要找的一个人是个刚出生的婴儿，还没起名子也没有入户口（身份证号），但是你会永远跟在你父亲的身边，你的父亲是有唯一的名字和身份证号的，这样我们可以先找到你父亲，自然就找到你的。
元素的上级属性为：
<form id="form1" class="fm" action="/s" name="f1">
<span class="bg s_ipt_wr">
<input id="kw1" class="s_ipt" type="text" maxlength="100" name="wd" utocomplete="off">
找爸爸：
xpath = //span[@class=’bg s_ipt_w’]/input
如果爸爸没有唯一的属性，可以找爷爷：
xpath = //form[@id=’form1’]/span/input
这样一级一级找上去，直到 html ，那么就是一个绝对路径了。
- 布尔值写法：
如果一个人的姓名不是唯一的，身份证号也不是唯一的，但是同时叫张三 并且 身份证号为 123 的人却可以唯一的确定一个人。那么可以这样写：
Xpath = //input[@id=’kw1’ and @name=’wd’]
可以 and ，当然也可以 or :
Xpath = //input[@id=’kw1’ or @name=’wd’]
但 or 的实际意义不太。我们一般不需要说，找的人名字或者叫张三，或者身份证号是 123 也可以
Robot framework 中的写法：
2.4 css 定位
CSS(Cascading Style Sheets)是一种语言，它被用来描述 HTML 和 XML 文档的表现。CSS 使用选择器来为页面元素绑定属性。这些选择器可以被 selenium 用作另外的定位策略。
CSS 可以比较灵活选择控件的任意属性，一般情况下定位速度要比 XPath 快，但对于初学者来说比较难以学习使用，下面我们就详细的介绍 CSS 的语法与使用。
CSS 选择器的常见语法：
- 通过 class 属性定位：
css=.s_ipt
css=.bg s_btn
csscss_selector()方法用于 CSS 语言定位元素，点号（.）表示通过 class 属性来定位元素。
- 通过 id 属性定位：
css=#kw
css=#su
井号（#）表示通过 id 属性来定位元素。
- 通过标签名定位：
css=input
在 CSS 语言中用标签名定位元素不需要任何符号标识，直接使用标签名即可，但我们前面已经了解到标签名重复的概率非常大，所以通过这种方式很难唯一的标识一个元素。
- 通过父子关系定位：
css=span>input
上面的写法表示有父亲元素，它的标签名叫 span，查找它的所有标签名叫 input 的子元素。
- 通过属性定位：
css=input[autocomplete='off']
css=input[maxlength='100']
css=input[type='submit']
在 CSS 当中也可以使用元素的任意属性，只要这些属性可以唯一的标识这个元素。
- 组合定位：
我们当然可以把上面的定位策略组合起来使用，这样就大大加强了元素的唯一性。
css=span.bg s_ipt_wr>input.s_ipt
css=span.bg s_btn_wr>input#su
有一个父元素，它的标签名叫 span，它有一个 class 属性值叫 bg s_ipt_wr，它有一个子元素，标签名叫 input，并且这个子元素的 class 属性值叫 s_ipt。好吧！我们要找的就是具有这么多特征的一个子元素。
Robot framework 中的写法：
三、SeleniumLibrary 关键字关于 Selenium2Library 的关键字，我们可以参考通过 F5查找 Selenium2Library 关键字库：3.1浏览器驱动
通过不同的浏览器执行脚
浏览器对应的关键字：
open browser 同样也可以打开本地 html 页面，如：
备注：
- 要想通过不同的浏览打开 URL 地址，一定要安装浏览器相对应的驱动。
- chrome 的驱动为：chromedriver.exe 。
- IE 的驱动为：IEDriverServer.exe
- 浏览器默认为空时启动 FireFox。
3.2 关闭浏览器
close browser 关闭当前的浏览器。close all browser 关键所有打开的浏览器和缓存重置3.3 浏览器最大化
Maximize Browser Window 关键字使当前打开的浏览器全屏。3.4 设置浏览器窗口宽、高
get windows size 关键字用于打设置打开浏览器的宽度和高度。以像素为单位，第一个参数 800 表示宽度，第二个参数 600 表示高度
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 13:51:33.456 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 13:51:33.457 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-2.log
20211108 13:51:41.610 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 13:51:42.123 : INFO : Clicking button 'id=su'.
20211108 13:51:42.465 : INFO : ${width} = 1295
20211108 13:51:42.465 : INFO : ${height} = 695
20211108 13:51:42.466 : INFO : 1295
20211108 13:51:42.467 : INFO : 695
20211108 13:51:47.474 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.5 文本输入
input text 关键字用于向文本框内输入内容。
xpath=//* [@] ：表示元素定位，定位文本输入框。3.6 点击元素
Click Element 关键字用于点击页面上的元素，单击任何可以点击按钮、文字/图片连接、复选框、单选框、甚至是下拉框等。xpath=//* [@] ：表示元素定位，定位点击的元素。
3.7 点击按钮
Click Button关键字用于点击页面上的按钮。
Xpath=//* [@] ：表示元素定位，定位点击的按钮。3.8 等待元素出现
Wait Until Page Contains Element 关键字用于等待页面上的元素显示出来。Xpath=//* [@] ：表示元素定位，这里定位出现的元素42 ： 表示最长等待时间。Error ： 表示错误提示，自定义错误提示，如：“元素不能正常显示” 测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:00:30.027 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:00:30.028 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-3.log
20211108 14:00:38.176 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:00:38.519 : INFO : Clicking button 'id=su'.
20211108 14:00:38.867 : INFO : ${width} = 1295
20211108 14:00:38.867 : INFO : ${height} = 695
20211108 14:00:38.868 : INFO : 1295
20211108 14:00:38.869 : INFO : 695
20211108 14:00:43.879 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.9 获取title
get title 关键字用于获得当前浏览器窗口的 title 信息。这里只获取 title 是没有意义的，我们通常会将获取的 title 传递给一个变量，然后与预期结果进行比较。从而判断当前脚本执行成功。
执行结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:22:12.707 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:22:12.710 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-9.log
20211108 14:22:20.330 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:22:20.718 : INFO : Clicking button 'id=su'.
20211108 14:22:21.052 : INFO : ${a} = 百度一下，你就知道
20211108 14:22:21.053 : INFO : 百度一下，你就知道
20211108 14:22:21.055 : INFO : ${width} = 1295
20211108 14:22:21.056 : INFO : ${height} = 695
20211108 14:22:21.056 : INFO : 1295
20211108 14:22:21.057 : INFO : 695
20211108 14:22:26.065 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.10 获取text
get text 关键字用于获取元素的文本信息。xpath=//* [@] ： 定位文本信息的元素。3.11 获取元素属性值
3.1浏览器驱动
通过不同的浏览器执行脚
浏览器对应的关键字：
open browser 同样也可以打开本地 html 页面，如：
备注：
- 要想通过不同的浏览打开 URL 地址，一定要安装浏览器相对应的驱动。
- chrome 的驱动为：chromedriver.exe 。
- IE 的驱动为：IEDriverServer.exe
- 浏览器默认为空时启动 FireFox。
3.2 关闭浏览器
close browser 关闭当前的浏览器。close all browser 关键所有打开的浏览器和缓存重置
3.3 浏览器最大化
Maximize Browser Window 关键字使当前打开的浏览器全屏。
3.4 设置浏览器窗口宽、高
get windows size 关键字用于打设置打开浏览器的宽度和高度。以像素为单位，第一个参数 800 表示宽
度，第二个参数 600 表示高度
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 13:51:33.456 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 13:51:33.457 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-2.log
20211108 13:51:41.610 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 13:51:42.123 : INFO : Clicking button 'id=su'.
20211108 13:51:42.465 : INFO : ${width} = 1295
20211108 13:51:42.465 : INFO : ${height} = 695
20211108 13:51:42.466 : INFO : 1295
20211108 13:51:42.467 : INFO : 695
20211108 13:51:47.474 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.5 文本输入
input text 关键字用于向文本框内输入内容。
xpath=//* [@] ：表示元素定位，定位文本输入框。
3.6 点击元素
Click Element 关键字用于点击页面上的元素，单击任何可以点击按钮、文字/图片连接、复选框、单选
框、甚至是下拉框等。
xpath=//* [@] ：表示元素定位，定位点击的元素。
3.7 点击按钮
Click Button关键字用于点击页面上的按钮。
Xpath=//* [@] ：表示元素定位，定位点击的按钮。
3.8 等待元素出现
Wait Until Page Contains Element 关键字用于等待页面上的元素显示出来。
Xpath=//* [@] ：表示元素定位，这里定位出现的元素
42 ： 表示最长等待时间。
Error ： 表示错误提示，自定义错误提示，如：“元素不能正常显示”
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:00:30.027 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:00:30.028 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-3.log
20211108 14:00:38.176 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:00:38.519 : INFO : Clicking button 'id=su'.
20211108 14:00:38.867 : INFO : ${width} = 1295
20211108 14:00:38.867 : INFO : ${height} = 695
20211108 14:00:38.868 : INFO : 1295
20211108 14:00:38.869 : INFO : 695
20211108 14:00:43.879 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.9 获取title
get title 关键字用于获得当前浏览器窗口的 title 信息。
这里只获取 title 是没有意义的，我们通常会将获取的 title 传递给一个变量，然后与预期结果进行比较。从而判断当前脚本执行成功。
执行结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:22:12.707 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:22:12.710 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-9.log
20211108 14:22:20.330 : INFO : Typing text 'robotframeworkѧϰ' into text field 'id=kw'.
20211108 14:22:20.718 : INFO : Clicking button 'id=su'.
20211108 14:22:21.052 : INFO : ${a} = 百度一下，你就知道
20211108 14:22:21.053 : INFO : 百度一下，你就知道
20211108 14:22:21.055 : INFO : ${width} = 1295
20211108 14:22:21.056 : INFO : ${height} = 695
20211108 14:22:21.056 : INFO : 1295
20211108 14:22:21.057 : INFO : 695
20211108 14:22:26.065 : INFO : Slept 5 seconds
Ending test: Test Project.Test Suit.baidu_search
3.10 获取text
get text 关键字用于获取元素的文本信息。
xpath=//* [@] ： 定位文本信息的元素。
3.11 获取元素属性值
id=kw@name：id=kw 表示定位的元素。@nam 获取这个元素的 name 属性值。
3.12 cookei 处理
- get cookies 获得当前浏览器的所有 cookie 。
- get cookie value 获得 cookie 值。key_name 表示一对 cookie 中 key 的 name 。
- add cookie 添加 cookie。添加一对 cooke （key：value）
- delete cookie 删除 cookie。删除 key 为 name 的 cookie 信息。
- delete all cookies 删除当前浏览器的所有 cookies。
3.13 验证
获得浏览器 title 进行比较。
- Open Browser 通过 chrome 打开百度首页。
- Get Title 获得浏览器窗口的 titile ，并赋值给变量${title}
- Should Contain 比较${title}是否等于“百度一下，你就知道”。
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 14:52:20.175 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 14:52:20.176 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-11.log
20211108 14:52:27.393 : INFO : ${title} = 百度一下，你就知道
20211108 14:52:27.426 : INFO : Typing text 'robotframework学习' into text field 'id=kw'.
20211108 14:52:27.842 : INFO : Clicking button 'id=su'.
20211108 14:52:29.741 : INFO : ${a} = robotframework学习_百度搜索
20211108 14:52:29.742 : INFO : robotframework学习_百度搜索
20211108 14:52:29.745 : INFO : ${width} = 1295
20211108 14:52:29.745 : INFO : ${height} = 695
20211108 14:52:29.746 : INFO : 1295
20211108 14:52:29.747 : INFO : 695
20211108 14:52:31.760 : INFO : Slept 2 seconds
Ending test: Test Project.Test Suit.baidu_search
获得文本信息进行比较
测试结果：
Starting test: Test Project.Test Suit.baidu_search
20211108 15:17:03.377 : INFO : Opening browser 'firefox' to base url 'https://www.baidu.com'.
20211108 15:17:03.379 : INFO : Firefox driver log is always forced to to: C:\Users\yzp\AppData\Local\Temp\RIDE_x45edr9.d\geckodriver-17.log
20211108 15:17:10.732 : INFO : ${title} = 百度一下，你就知道
20211108 15:17:10.754 : INFO : Typing text 'robotframework学习' into text field 'id=kw'.
20211108 15:17:11.217 : INFO : Clicking button 'id=su'.
20211108 15:17:19.166 : INFO : Slept 5 seconds
20211108 15:17:19.189 : INFO : ${text} = 帮助
20211108 15:17:19.194 : INFO : ${width} = 1295
20211108 15:17:19.194 : INFO : ${height} = 695
20211108 15:17:19.195 : INFO : 1295
20211108 15:17:19.205 : INFO : 695
20211108 15:17:21.209 : INFO : Slept 2 seconds
Ending test: Test Project.Test Suit.baidu_search
3.14 表单嵌套
有时候和页面中会出现表单嵌套，这个时候需要进入到表单才能操作相关元素。
Select Frame 进入表单，Xpath=//* [@] 表示定位要进入的表单。
Unselect Frame 退出表单。
3.15 下拉框选择
Unselect From List By Value 关键字用天选择下拉框。
Xpath=//* [@] 定位下拉框；
Vlaue 选择下拉框里的属性值。
3.16 执行 JavaScript
在一些特殊的情况下需要调用 JavaScript 代码。
Execute Javascript 关键字用于使用 JavaScript 代码
四、Robot Framework 分层设计谈到 Robot Framework 分层的思想，就不得不提“关键字驱动”。回到分层的思想上，在程序设计的讲究设计模式，设计模式其实就是根据需求使用抽象与封装，其实就是分层思想。把一个实现过程分成不同多层。提高的灵活性，从而达到可扩展性和可维护性。再回到自动化的话题上，我们可以把操作步骤封装一个一个的方法（关键字），通过调用关键字来实现测试用例。参考前面创建的一条百度搜索的测试用例。1、创建资源
右键“测试项目”选择“new resource”创建资源。
2、创建关键字
右键“业务关键字”选择“new User Keyword” 来创建用户关键字
输入关键字的名称：
3、编辑关键字
分析：
对于一个测试用例来说，用户关心的是输入什么内容，得到什么结果。
所以，对于“百度搜索”关键字来说，需要创建两个接口变量${search}和${result} 两个变量，用于接收输入内容和预期结果。
点击 Arguments 输入框，定义变量，多个变量从用“|”隔开。
在百度用户中使用参数化变量。
4、添加创建的资源
切换到测试套件（Search）页面，添加资源（业务关键字.txt）
5、调用关键字
现在就可以在测试用例中使用创建的关键字了（百度搜索）。
对于每一条用例来说，调用“百度搜索”关键字，输入搜索内容，输入预期结果即可。不同关心用例是如何执行的。如果百度输入框的定位发生了变化，只用去修改“百度搜索”关键字即可，不用对每一条用例做任何修改。大大提高的用例的维护性和扩展性。
继续分层的设计：
到此，Robot Framework +Selenium 自动化测试粗犷的讲完了。当然还有更多 API 的使用，和细枝末节的设置没有介绍。但我们已经可以拿它来开展自动化工作了。
