内置库又称Standard Library，即标准库，还有一种External library，即扩展库，也称为第三方库。
标准库直接绑定在rf内，扩展库需要自行下载然后安装导入使用，标准库也分为两类，使用前不需导入的库：builtin，这类库是rf自动加载；另一类使用前需要导入，如collections，这类库使用前需要导入才能使用库中的关键字。
RF 标准库无需下载，直接导入使用即可，包括：
库名 作用 是否需要导入 Builtin 包括经常使用的关键字，如Evaluate，Log关键字， F Dialogs 提供了暂停测试执行和从用户输入的方式， T collections 提供一组关键字处理python列表和字典， T OperatingSystem 执行各种操作系统相关的任务 T Remote 远程库接口的一部分，本身没有任何关键字，作为rf和测试库之间代理的特殊库，实际测试库可以在不同的机器上运行，可以使用任何编程语言支持XML-RPC协议的实现 T Screenshot 提供关键字来捕获和存储桌面的截图， T string 用于处理字符串并验证他们的内容，如修改，生成，验证字符串 T Telnet 支持连接到telnet服务器上 T xml 用于生成、修改、和验证xml文件的库 T Process 系统中运行过程的库 T DateTime 日期和时间转换的库，支持创建和验证日期和时间值以及他们之间的计算 T
XML-RPC协议：请求体为xml的http-post请求，服务器把执行结果以xml格式编码返回
Telnet：TCP/IP协议族中的一员，是internet远程登陆服务的标准协议和主要方式，提供了在本地计算机完成远程主机工作的能力，是常用的远程控制web服务器的方法。
rf需要下载安装后使用的库，这里不一一列举
Android library：所有android自动化需要的测试库，内部使用的是Calabash Android
iOS library：所有iOS自动化需要的测试库，内部使用Calabash iOS服务
appiumlibrary：Android和iOS测试库，内部使用的是appium
HTTP library (livetest)：内部使用LiveTest工具的HTTP测试的库。
HTTP library (Requests)：内部使用request工具的HTTP测试的库。
MongoDB library：使用pymongo和MongoDB交互的库。（MongoDB是一个基于分布式文件存储的数据库）
Database Library (Java)：基于Java的数据库测试库。也可使用Jython和Maven central.
Database Library (Python)：基于Python数据库测试库。支持任何Python解释器，包括Jython。
watir-robot：使用Watir的工具的Web测试库。
seleniumlibrary：Web测试库，内部使用比较流行的selenium工具。利用早期的selenium1.0和本身已经过时。
selenium2library：使用selenium2的Web测试库。替换了大部分老的seleniumlibrary。
selenium2library java：selenium2library的java接口
Django Library：为Django的库，一个Python Web框架。
sudslibrary：一种基于泡沫基于SOAP的Web服务的功能测试库，动态的SOAP 1.1的客户端。
Archive library：处理.zip和.tar压缩包的库。
Diff Library：比较两个文件的库。
FTP library：Robot Framework上测试和使用FTP服务的库。
SSHLibrary：通过SSH连接的在远程机器上执行命令。还支持使用SFTP进行文件传输
rammbock：通用的网络协议测试库；提供简单的方法来指定网络数据包，并检查发送和接收数据包的结果。
imagehorizonlibrary：跨平台、基于图像识别的GUI自动化纯Python库。
autoitlibrary：Windows的GUI测试库，使用AutoIt的免费工具作为驱动。
Eclipse Library：使用SWT窗口小部件测试Eclipse RCP应用程序的库。
robotframework-faker：一个服务faker的库，faker的测试数据生成器。
swinglibrary：用Swing GUI测试java应用程序库
remoteswinglibrary：使用swinglibrary库测试和连接一个java进程，尤其是java web
MQTT library：测试MQTT brokers和应用的库。
Evaluate关键字在rf框架中被称为万能关键字，他能让你直接运行python脚本，在标准库和扩展库都不能满足功能需求时，直接使用python脚本实现。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Bov5SRha-1619166759213)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210324103322318.png)]
第一个参数：expression，指表达式
第二个参数：modules， 指需要导入的模块,默认值None
第三个参数：namespace： 指命名作用空间，默认值None
个人理解：就是直接跟python代码。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-AZtSZ8WD-1619166759218)(C://Users//super//Documents//JD//office_dongdong//ext.zhangliuxin//Temp//JdOnline20210324122356.png)]
使用关键字时，表达式参数需要加上引号，如上图。
evaluate可以处理简单的关系，当需要处理复杂的关系时，推荐通过自定义测试库和开发系统关键字。
类型转换可以将某个类型的变量值转化为指定类型的值
示例：
${string} Convert To String hello world Log ${string}
所属库 参数 builtin item，base(指定转换为什么进制，0b表示二进制，0o表示八进制，0x表示十六进制)=None
示例：
${int} Convert To integer 50 Should be equal ${int} ${50}
首先先将50（此时是字符串‘50’）转化为整数，然后和数字50进行比较
所属库 参数 builtin item，precision=None
示例：
${float} Convert To number 32.512 log ${float} # 打印32.512
${float} Convert To number 32.512 1 log ${float} # 打印32.5
${float} Convert To number 32.512 0 log ${float} # 打印33.0
${float} Convert To number 32.512 -1 log ${float} # 打印30，（如果为-2，则输出0）
所属库 参数 builtin item，precision=None
简单来说：关键字接受的参数如果为非空值，返回true，如果参数为空值，如：
N
U
L
L
,
{NULL},
N U L L ,
所属库 参数 string string，encoding，errors=strict
errors有三种取值：
strict：默认参数，当字符无法编码时返回失败。 ignore：当字符不能编码时忽略。 replace：当字符不能编码时，使用替换字符来代替 ${string} set variable 验证通过 ${to_utf8} encode string to bytes ${string} UTF-8
${var} set variable 本地变量 log variables
先要新建变量文件文件名为variable.py,文件内容如下
# coding=utf-8
url=‘http：//www.yaosi.com’
str_list=['a','b','c']
import variable ${CURDIR}/variable.py log ${url} log many @{str_list}
变量名1 变量名2 set variable 变量值1 变量值2
该关键字只在当前作用范围内有效。
set global variable ${global_var} hello world
需要注意的点：1.如果是在测试用例创建的变量，要保证该测试用例优先执行；2.对于全局变量，在运行过程中的所有测试套件或测试用例都有效。
set suite variable ${suite_var} hello world ${id} set variable 123456 set suite variable ${id}
测试套件变量仅对该测试套件及该测试套件下的测试用例有效。
set test variable ${test_var} hello
测试用例变量仅对该测试用例有效。
所属库 参数 builtin condition，*values
${RE} set variable ${0} ${val1} set variable if ${RE}==0 zero nozero ${val1} set variable if ${RE}>0 value1 value2 ${val1} set variable if ${RE<0 whatever
结果为：zero，value2，None
所属库 参数 builtin name，default=None
所属库 参数 operatingSystem name，default=None
所属库 参数 operatingSystem name，value
${time} run keyword get time Log ${time}
所属库 参数 builtin condition，name，*args
run keyword if ‘${STATUS}’=‘PASS’ SOME ACTION
${STATUS}的冒号不可以省略。
所属库 参数 builtin condition，name，*args
所属库 参数 builtin times，name，*args
当执行多个需要参数的关键字时，关键字使用AND连接（区分大小写），运行次序是依次运行。
参数名（接收返回值信息） run keyword and return 关键字
所属库 参数 builtin condition，name，*args
参数名（接收返回值信息） run keyword and return if 条件 关键字
run keyword and continue on failure Fail 关键字
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-BPSZK51o-1619166759222)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406111122391.png)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-nsroQny5-1619166759226)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406111419211.png)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-uOqViUzH-1619166759232)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406113057618.png)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-W2xgO5qq-1619166759234)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406113225271.png)]
所属库 参数 builtin itme|msg=None
判断 item是否为空，实际上通过调用get length关键字获取对应元素的长度是否为0，为0则为空，否则不为空。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-F1w5rg3c-1619166759237)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406143453398.png)]
所属库 参数 builtin first|second|msg=None|values=Ture|ignore_case=False
如果此关键字失败，则构造错误消息方法：
如果没有给出msg，则错误消息为!=. 如果给出msg并且values得到一个真值，则错误消息是:!=. 如果给出msg并且values得到一个假值，则错误消息是 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-ycgDYURB-1619166759238)(C:\Users\super\AppData\Roaming\Typora\typora-user-images\image-20210406144817327.png)]
所属库 参数 builtin first|second|msg=None|values=Ture|ignore_case=False
所属库 参数 builtin condition，msg=None
如果condition是一个字符串则使用python的内置函数eval来处理表达式。
所属库 参数 builtin container|item|msg=None|values=Ture|ignore_case=False
适用于所有字符串，列表，和任何支持python的in表达式运算符对象。
所属库 参数 builtin container|*items|**configuration
1.7.8 should contain x times:断言某元素是否被包含指定次数.
所属库 参数 builtin item1|item2|count|msg=none|ignire_case=False
适用于字符串，列表等支持get count关键字的对象，msg会覆盖默认的错误信息，实际次数会记录在日志里。
所属库 参数 builtin str1,str2|msg=none|values=True|ignore_case=False
所属库 参数 builtin str1,str2|msg=none|values=True|ignore_case=False
所属库 参数 builtin string|pattern|msg=None|values=True
使用regexp需要注意
反斜杠是转义字符，使用反斜杠需要双重转义即\\（表示第一个反斜杠转义了第二个反斜杠）。、 需要转义的特殊字符可以使用regexp ESCAPE关键字 pattern不会匹配整个字符串，例如模式‘ello’会匹配字符串’hello world‘,如果要完整匹配，’^‘匹配开头，“$”匹配结尾。 如果关键字成功，则他返回字符串匹配模式的一部分，还可以返回元组。 所属库 参数 builtin item|length|msg=None
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-duKWRd6U-1619166759240)(C://Users//super//Documents//JD//office_dongdong//ext.zhangliuxin//Temp//JdOnline20210408110341.png)]
所属库 参数 builtin name|msg=None
keyword should exist ${关键字} keyword should exist ${模块名.关键字}
当存在多个同名关键字时，可以使用模块名.关键字断言
所属库 参数 Collections list|value|msg=None
list should contain value ${LIST} name
所属库 参数 Collections list1|list2|msg=None|values=True|names=None
lists should be equal ${LIST1} ${LIST2}
所属库 参数 Collections list|msg=None
list should not contain duplicates ${LIST}
所属库 参数 Collections dictionary|key|value|msg=None
dictionary should contain item ${DICT} key value
所属库 参数 Collections dictionary|key|msg=None
dictionary should (not)contain key ${DICT} key
所属库 参数 Collections dictionary|value|msg=None
dictionary should (not)contain value ${DICT} value
所属库 参数 Collections dict1|dict2|msg=None|values=True
dictonaries should be equal ${DICT1} ${DICT2}
所属库 参数 Collections list_|level=INFO
@{list} create list a log list ${list} level=INFO
所属库 参数 Collections list_|*values
@{list} create list a append to list ${list}
所属库 参数 Collections list_|index|value
@{list} create list a b insert into list ${list} 0 ${1}
${list} create list a b @{new_list} copy list ${list}
所属库 参数 Collections list_|index
@{list} create list a b ${x} get from list ${list}
所属库 参数 Collections list_|value|start=0|end=None
@{list} create list a b ${a_index} get index from list ${list} a
@{list} create list a b reverse list ${list}
所属库 参数 Collections list_|index|value
@{list} create list a set list value ${list} 0 bb
@{list} create list a sort list @{list}
所属库 参数 Collections list_|index
@{list} create list a ${delete} remove from list ${list} 0
所属库 参数 Collections list_|*values
@{list} create a remove values from list ${list} a
@{list} create list a b remove duplicates ${list} a
&{dict} create dictionary name=mike age=19
所属库 参数 Collections dict|level=info
&{dict} create dictionary name=mike age=19 log dictionary ${dict}
所属库 参数 Collections dict|*key_value_pairs|**items
&{dict} create dictionary name=mike age=19 set to dictionary ${dict} sex man
&{dict} create dictionary name=mike age=19 &{new_dict} copy dictionary ${dict}
&{dict} create dictionary name=mike age=19 ${itmes} get dictionary itmes ${dict}
取出的值为：[‘name’,‘mike’,‘age’,‘18’]
&{dict} create dictionary name=mike age=19 ${new_list} get dictionary keys ${dict}
&{dict} create dictionary name=mike age=19 ${values} get dictionary values ${dict}
&{dict} create dictionary name=mike age=19 ${age} get from dictionary ${dict} age
所属库 参数 Collections dict|key|default(当列表中不存在该值时，使用default值)=
&{dict} create dictionary name=mike age=19 ${age} pop from dictionary ${dict} age default=18
所属库 参数 Collections dict|*key
&{dict} create dictionary name=mike age=19 remove from dictionary ${dict} name age
所属库 参数 builtin msg|level=info|html=false|console（是否输出到控制台）=false|repr（按照unicode编码原样显示）=False
其中level有五个级别：trace，debug，info（默认）,html,warn,error,其中warn和error记录的消息可在控制台和日志报告中的错误提示栏看到，
log hello world console=True
log many @{list} &{dict} log many hello world
注意：字典和列表应该使用各自的标识：字典&。列表@
所属库 参数 builtin msg|stream（标准流）=STDOUT|no_newline(不换行)=false
格式1：1 day 2 hours 3 minutes 4 seconds 5 milliseconds
格式2 ：1d 2h 3m 4s 5ms
所属库 参数 builtin time|reason(说明)=None
1.9.5 comment:对参数添加注释，不进行任何处理，且会显示在日志中。
comment 增加注释 comment sleep 10
所属库 参数 builtin object|method_name|*args|**kwargs
call method ${hashtable} put value1 value2 ${value}= call method ${hashtable} get value1
1.通过关键字调用hashtable对象的put方法，向里面加入新值value1，value2
2.调用hashtable对象的get方法，取出value1
${count} get count ${some} sub
item可以是任何有长度的对象，如字符串，列表，集合，
${length}= get length hello world
所属库 参数 builtin format=timestamp|time=now
1.如果格式中包含epoch，返回的是从（Jan 1，1970，0：00：00）开始计算的秒数
如果格式中包含year，month，day，hour，min或sec，则返回对应部分。
默认格式为2021-04-13 12：07：34
有效的时间戳，比如YYYY-MM-DD hh:mm:ss和YYYYMMDD hhmmss.
now:不区分大小写，为当前时间，
now -1 day 或now+ 1 hour 30 min 等会计算时间
pass execution log 此条语句不会执行
所属库 参数 builtin condition|msg|*tags
FOR ${var} in @{values} pass execution if ‘${var}’==‘a’ log hello
当var的取值时a时，会跳过打印hello，否则打印hello
所属库 参数 builtin msg=None|*tags
可以使用WITH NAME来更改库名，用于增加别名。
import library mylibray import library mylibray WITH NAME mylib
导入成功显示黑色，失败显示红色
本文详细介绍了Robot Framework中的内置库（如Builtin、Dialogs等）及其功能，同时涵盖了如何使用扩展库如Androidlibrary、seleniumlibrary等。重点讲解了Evaluate万能关键字和类型转换技巧，以及变量操作、关键字操作和条件控制等核心概念。
扫一扫
524
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
