JMeter（十六）-JMeter断言

十六、JMeter断言

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新增：线程组 > 添加 > 断言 > XPath2 Assertion，如下图所示：

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新建：线程组 > 添加 > 断言 > MD5 Hex断言，如下图所示：

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新建：线程组 > 添加 > 断言 > XML Schema断言，如下图所示：

3.11.2关键参数说明如下：

文件名：载入文件名，（写入需要断言的文件名称）

3.12XML断言

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

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

使用频率：少

3.12.1新建：线程组 > 添加 > 断言 > XML断言，如下图所示：

3.13Xpath 断言

使用频率：一般

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的变量名称)

XML Parsing Options：XML解析选项

Use Tidy(tolerant parser)：使用Tidy（容错解析器），默认选择quiet（不显示）
- Quiet：不显示
- 报告异常
- 显示警告
Use Namespaces：使用名称空间
Validate XML：验证XML（文件包/数据）
Ignore Whitespace：忽略空格（这允许你指定语法分析器可以忽略哪个空格，而哪个空格是重要的）
Fetch external DTDs：获取外部DTDs（一些XML元素具有属性，属性包含应用程序使用的信息，属性仅在程序对元素进行读、写操作时，提供元素的额外信息，这时候需要在DTDs中声明）

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