1.简介

断言组件用来对服务器的响应数据做验证,常用的断言是响应断言,其支持正则表达式。虽然我们的通过响应断言能够完成绝大多数的结果验证工作,但是JMeter还是为我们提供了适合多个场景的断言元件,辅助我们来更好的完成结果验证工作。在使用JMeter进行性能测试或者接口自动化测试工作中,经常会用到的一个功能,就是断言,断言相当于检查点,它是用来判断系统返回的响应结果是否正确,以此帮我们判断测试是否通过。

2.预览断言

首先我们来看一下JMeter的断言,路径:线程组(用户)->添加->断言;我们可以清楚地看到JMeter5中共有15个断言(不包括jp@gc开头的断言,这个是安装的插件),如下图所示:

 

3.常用断言详解

比较常用的断言:响应断言、JSON断言、持续时间断言

3.1 响应断言

响应断言,判断返回消息中的内容。响应断言是最常用的一种断言方法,它可以对各种返回类型的结果进行断言,比如Test、html、application/json等

使用频率:非常高,大部分场景均可以使用该断言器

3、 1.1新建:线程组>添加>断言>响应断言,如下图所示:;

 

3、 1.2关键参数说明如下:;

APPly to:

  • Main sample and sub-samples:作用于父节点取样器及对应子节点取样器
  • Main sample only:仅作用于父节点取样器(默认)
  • Sub-samples only:仅作用于子节点取样器
  • JMeter Variable Name to use:作用于jmeter变量(输入框内可输入jmeter的变量名称)

测试字段

  • 响应文本:从服务器返回的响应文本,比如body,包含 HTTP 头(请求的响应数据——Response Body)
  • 响应代码:比如 200、404(请求的取样器结果中的 Response code)
  • 响应消息:比如 OK(请求的取样器结果中的 Response message)
  • 响应头:比如 Set-Cookie 头(请求的响应数据——Response headers)
  • 请求头:(请求的请求——Request Headers)
  • URL样本:请求的地址(请求的请求——Request Body 中的地址)
  • 文档(文本):通过 Apache Tika 追踪的各种类型文档的文本(比如返回的是HTML格式,其中的文本信息)
  • 忽略状态:指示 JMeter 设置 sampler status 的初始状态为 success。sample status 是否成功,由已 Response status 和断言结果决定,当选中 Ignore Status 时,Response status 被强制设置为 success,不执行进一步的断言判断。仅第一次断言时使用
  • 请求数据:(请求的请求——Request Body)

模式匹配规则

  • 包括:响应内容包括需要匹配的内容即代表响应成功,支持正则表达式
  • 匹配:响应内容要完全匹配需要匹配的内容即代表响应成功,大小写不敏感,支持正则表达式。
  • 相等:响应内容要完全等于需要匹配的内容才代表成功,大小写敏感,需要匹配的内容是字符串正则表达式
  • 字符串:返回结果包含指定结果的字串,但是 subString 不支持正则字符串
  • 否:不进行匹配

测试模式: 与模式匹配规则一同使用,可以直接写值也可以使用正则表达式

自定义失败消息: 自定义失败消息

3.2JSON断言

JSON断言也是测试工作中经常用到的一种断言方法,它只能针对响应结果是applicaton/json格式的请求进行断言。适用于返回消息是JSON格式

使用频率:比较高,尤其是返回为 JSON 时,为首先断言器

3、 2.1新建:线程组>添加>断言>JSON断言,如下图所示:;

 

3、 2.2关键参数说明如下:;

Assert JSON Path exists: json路径

Additionally assert value:等于特定值

Match as regular expression:正则匹配

Expected Value:预期值;支持脚本语言写法

Expect null:空值

Invert assertion(will fail if above conditions met):上面的条件满足则fail;若勾选,表示对断言结果取反

3.3大小断言

大小断言,显示取样器请求和响应的细节以及请求结果,包括消息头,请求的数据,响应的数据。判断响应结果是否包含正确数量的byte。可定义(=, !=, >, =,

使用频率:一般

3、 3.1新建:线程组>添加>断言>大小断言,如下图所示:;

 

3、 3.2关键参数说明如下:;

APPly to:

  • Main sample and sub-samples:作用于父节点取样器及对应子节点取样器
  • Main sample only:仅作用于父节点取样器(默认)
  • Sub-samples only:仅作用于子节点取样器
  • JMeter Variable Name to use:作用于jmeter变量(输入框内可输入jmeter的变量名称)

响应字段大小

  • 完整响应
  • 响应头
  • 响应的消息体
  • 响应代码
  • 响应信息

Size to Assert:断言字节范围

  • 字节大小
  • 比较类型

3.4 JSR223 断言

JSR223即Java 规范请求,是指向JCP(Java Community Process)提出新增一个标准化技术规范的正式请求;

作用对象:针对取样器中的JSR223 sampler而使用的断言

使用频率:一般

3、 4.1新建:线程组>添加>断言>JSR223断言,如下图所示:;

 

3、 4.2关键参数说明如下:;

语言:脚本语言(可以从下面的下拉框中选择对应的脚本语言JavaScript、beanshell等)

参数:(传递给脚本的参数→可以理解为使用JSR223断言脚本时候一起引用的参数 )

文件名:重写脚本(可以通过选择脚本文件的状态,是浏览调用已有的脚本还是在在下方的输入框内写入脚本;)

脚本:下面的输入框表示可以输入变量类型,运用的脚本(取样结果、断言结果、取样日志文件等参数)

3.5XPath2 Assertion

XPath即为XML路径语言,它是一种用来确定XML(标准通用标记语言的子集)文档中某部分位置的语言。XPath基于XML的树状结构,提供在数据结构树中找寻节点的能力。

使用频率:一般

3、 5.1新增:线程组>添加>断言>XPath2Assertion,如下图所示:;

 

3、 5.2关键参数说明如下:;

APPly to:

  • Main sample and sub-samples:作用于父节点取样器及对应子节点取样器
  • Main sample only:仅作用于父节点取样器(默认)
  • Sub-samples only:仅作用于子节点取样器
  • JMeter Variable Name to use:作用于jmeter变量(输入框内可输入jmeter的变量名称)

XPath2 Assertion

  • 反转断言(如果XPath表达式匹配,则将失败)
  • 验证XPath表达式

命名空间别名列表

输入框中写入xpath断言

3.6 比较断言

这是一种比较特殊的断言元件,针对断言进行字符串替换时使用;

作用对象:需要替换的字符串

使用频率:一般

3、 6.1新建:线程组>添加>断言>比较断言,如下图所示:;

 

3、 6.2关键参数说明如下:;

选择比较运算符

  • 比较的内容:可以选择比较的内容类型(true/false或者自定义,编辑)
  • 比较的时间:比较时间(可以设定比较的时间,单位为秒,默认为-1)

比较过滤器

  • 正则表达式替换

  • 正则表达式:要替换的正则表达式(可从断言结果中选择)

  • 替换:替换的正则表达式(替换结果)

3.7 HTML断言

对响应类为XML类型的文件进行断言;

作用对象:针对sampler中的SOAP/XML-RPC Request而使用的断言

使用频率:一般

3、 7.1新建:线程组>添加>断言>HTML断言,如下图所示:;

 

3、 7.2关键参数说明如下:;

Tidy Settings:Tidy 环境(Tidy是一个HTML语法检查器和打印工具,可以将HTML转换为XML类型的文件)

  • Doctype:文档类型(可通过下拉框选择不同文档类型→ omit疏忽遗漏的/auto动态的/strict严格的/loose)

Format:文件格式(可选择HTML/XHTML/XML三种不同类型的文件格式来检查返回内容)

Errors only:误差校正(能接受的最大值)

Error threshold:误差/错误范围(可选择误差/错误数量的范围,最大值)

Warning threshold:警告范围(可选择误差警告的数量范围,最大值)

如果勾选“Error only”这里忽略Warning,只对误差作统计检查;如果对返回内容的检查结果不超过指定结果,则断言通过,否则失败。

将JTidy报告写入文件:写入JTidy报告的文件(JTidy是Tidy的一个java移植,可以将它当成一个处理HTML文件的DOM解析器)

3.8JSON JMESPath Assertion

同JSON断言类似,不详细讲解

 

3.9MD5 Hex断言

MD5是一种消息摘要算法,用以提供消息的完整性保护,对返回的MD5结果进行断言,使用简单,直接跳入MD5值。执行服务器响应的MD5哈希并将其与给定的Md5哈希进行比较。它非常适合您要检查下载文件是否完整的情况。

作用对象:针对参数类型为MD5Hex加密的参数的断言

3、 9.1新建:线程组>添加>断言>MD5Hex断言,如下图所示:;

 

3、 9.2关键参数说明如下:;

MD5Hex:将已被MD5加密的参数写入其中,添加取样器等其他元件

3.10 SMIME断言

SMIME是一种多用途网际邮件扩充协议,相比于之前的SMAP邮件传输协议,增加了安全性,对邮件主题进行保护;

作用对象:针对采用了该种邮件传输协议的信息

使用频率:少

3、 10.1新建:线程组>添加>断言>SMIME断言,如下图所示:;

 

3、 10.2关键参数说明如下:;

signature:签名(可选择对协议的签名验证状态)

  • Verify signature:验证签名
  • Message not signed:没有签名消息

Signer certificate:签名证书(因为SMIME协议增加了安全传输,需要证书验证)

  • No check:不检查
  • Check values:检查

Signer distinguished name:签名证书者名称(证书注册者的名称)

Sigmer email address:签名者的邮件地址(注册的邮件地址)

Issuer distinguished name:发行者名称(由谁发行的证书)

Serial Number:证书序号

Certificate file:选择证书文件

Execute assertion message at position:执行断言消息的位置(在返回消息的具体哪个位置执行断言)

3.11XML Schema断言

亦可以称为XML模型断言/XML数据类型断言;XML Schema 定义了两种主要的数据类型:①xml document schema 文档架构 ;② 文档架构xml-schema xml模式

作用对象:返回结果为XML概要断言的2中数据类型的消息

使用频率:少

3、 11.1新建:线程组>添加>断言>XMLSchema断言,如下图所示:;

 

3、 11.2关键参数说明如下:;

文件名:载入文件名 ,(写入需要断言的文件名称)

3.12XML断言

XML(可扩展标记语言) 提供一种描述结构化数据的方法。与主要用于控制数据的显示和外观的 HTML 标记不同,XML 标记用于定义数据本身的结构和数据类型;

作用对象:判断返回结果是否和xml的格式即<>成对出现

使用频率:少

3、 12.1新建:线程组>添加>断言>XML断言,如下图所示:;

 

3.13Xpath 断言

XPath即为XML路径语言,它是一种用来确定XML(标准通用标记语言的子集)文档中某部分位置的语言。XPath基于XML的树状结构,提供在数据结构树中找寻节点的能力。

使用频率:一般

3、 13.1新增:线程组>添加>断言>Xpath断言,如下图所示:;

 

3、 13.2关键参数说明如下:;

APPly to:

  • Main sample and sub-samples:作用于父节点取样器及对应子节点取样器
  • Main sample only:仅作用于父节点取样器(默认)
  • Sub-samples only:仅作用于子节点取样器
  • JMeter Variable Name to use:作用于jmeter变量(输入框内可输入jmeter的变量名称)

XMLParsing Options:XML解析选项

  • Use Tidy(tolerant parser):使用Tidy(容错解析器),默认选择quiet(不显示)

  • Quiet:不显示

  • 报告异常

  • 显示警告

  • Use Namespaces:使用名称空间

  • Validate XML:验证XML(文件包/数据)

  • Ignore Whitespace:忽略空格(这允许你指定语法分析器可以忽略哪个空格,而哪个空格是重要的)

  • Fetch external DTDs:获取外部DTDs(一些XML元素具有属性,属性包含应用程序使用的信息,属性仅在程序对元素进行读、写操作时,提供元素的额外信息,这时候需要在DTDs中声明)

XPath 断言:输入框中写入xpath断言,点击“验证”验证其正确性

  • Invert assertion(will fail if XPath expression matches):反转断言(如果XPath表达式匹配,则将失败)

3.14 断言持续时间

断言持续时间,用于判断服务器的响应时间

使用频率:一般

3、 14.1新建:线程组>添加>断言>断言持续时间,如下图所示:;

 

3、 14.2关键参数说明如下:;

APPly to:

  • 选项默认即可,Main sample only(仅作用于父节点取样器)
  • Main sample and sub-samples:作用于父节点取样器及对应子节点取样器
  • Sub-samples only:仅作用于子节点取样器

断言持续时间

  • 持续时间(毫秒):响应时间设置,如果响应时间大于设置的响应时间,则断言失败,否则成功!

3.15 Bean Shell断言

BeanShell是一种松散类型的脚本语言(这点和JS类似),一种完全符合java语法的java脚本语言,并且又拥有自己的一些语法和方法;

BeanShell断言支持各种开发语言,本文介绍使用java编写断言,使用BeanShell断言的好处是可以自由发挥,比如当断言失败,提示预期结果、实际结果,或者失败时把结果输出到日志。

作用对象:针对sampler中的Bean Shell sampler而使用的断言

使用频率:一般

3、 15.1新建:线程组>添加>断言>BeanShell断言,如下图所示:;

 

3、 15.2关键参数说明如下:;

每次调用前重置bsh.Interpreter:在每次调用Bean Shell之前重置bsh.interpreter类(bsh.interpreter是Bean Shell脚本语言的一种类,也可以理解为一种解析器)

参数:String参数(String []bsh.args是主类main函数的形式参数,是一个String 对象数组,可以用来获取命令行用户输入进去的参数)

文件名:脚本文件(可以填入脚本文件路径)

脚本(see below for variables that are defined):参照下文定义的变量(使脚本文件参照定义的变量来运行)