robot_framewok自动化测试--（8）SeleniumLibrary 库（selenium、元素定位、关键字和分层设计）

SeleniumLibrary 库

一、selenium

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 = 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 获取元素属性值

　　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 的使用，和细枝末节的设置没有介绍。但我们已经可以拿它来开展自动化工作了。

posted on 2021-11-08 16:05 hello_殷阅读(747) 评论(0) 收藏举报

刷新页面返回顶部

Hello殷

robot_framewok自动化测试--（8）SeleniumLibrary 库（selenium、元素定位、关键字和分层设计）

SeleniumLibrary 库

一、selenium

1.1、Selenium 介绍

2.2、安装 SeleniumLibrary

1.3第一个例子

二、元素定位

2.1 前端工具

2.2 id 和 name 定位

2.3 xpath 定位

（1）xpath 的绝对路径：

（2）xpath 的相对路径：

2.4 css 定位

Robot framework 中的写法：

三、SeleniumLibrary 关键字

3.1浏览器驱动

3.2 关闭浏览器

3.3 浏览器最大化

3.4 设置浏览器窗口宽、高

3.5 文本输入

3.6 点击元素

3.7 点击按钮

3.8 等待元素出现

3.9 获取title

3.10 获取text

3.11 获取元素属性值

3.12 cookei 处理

3.13 验证

3.14 表单嵌套

3.15 下拉框选择

3.16 执行 JavaScript

四、Robot Framework 分层设计

1、创建资源

2、创建关键字

3、编辑关键字

4、添加创建的资源

5、调用关键字

导航

公告