一、前言
在 JMeter 中,断言元件(Assertion)用于验证测试结果是否符合预期。断言元件可以检查服务器的响应数据,以确保它们符合期望的模式或值,从而验证性能测试脚本的正确性。断言元件通常在每个请求的响应中添加,以确保服务器返回了正确的响应。
二、常用的JMeter断言元件
1. 常用断言元件
- Response Assertion(响应断言)
- Size Assertion(大小断言)
- XPath Assertion(XPath 断言)
- JSON Assertion(Json 断言)
2. 断言添加方式:
根据需要可在【测试计划】、【线程组】、【线程请求】下添加断言,一般在对应的【线程请求】下添加,如下图所示。
添加路径:【线程请求-点击右键-添加-断言-对应的断言形式】
3. 查看断言结果
3.1 【断言结果】看断言结果
添加路径:【测试计划-点击右键-添加-监听器-断言结果】
整个测试计划下所有请求的所有断言结果报错信息均会在此显示,如下图所示,将所有断言结果的报错信息直接展示出来。
3.2【查看结果树】看断言结果
添加路径:【测试计划-点击右键-添加-监听器-查看结果树】,整个测试计划下所有请求的所有断言结果报错信息均会在此显示,如下图的形式,切换查看。
三、断言元件的详细介绍
3.1 Response Assertion(响应断言)
3.1.1 简介
用于检查服务器响应的内容是否符合预期,可以基于响应的内容、代码、消息或其他属性进行断言。可以根据响应文本、响应代码、响应消息和其他参数来定义断言条件,并指定断言模式(包含、匹配、不包含等)。
3.1.2 参数配置介绍
-
Apply to 选项默认即可,Main sample only(仅作用于父节点取样器)。
-
测试字段:要检查的项 (实际结果)
- Text Response:来自服务器的响应文本。
- Response Code:响应的状态码,例如:200。
- Response Message:响应的信息,例如: OK。
- Response Headers: 响应头部
- Request Headers: 请求头部
- Request Data:请求数据
- URL 样本:请求 URL
- Document(text): 响应的整个文栏
- 忽略状态:忽略返回的响应状态码
-
模式匹配规则:比较方式(校验规则)
- contains(包括):文本包含指定的正则表达式
- Matches(匹配):整个文本匹配指定的正则表达式
- Equals(等于):整个返回结果的文本等于指定的字符串(区分大小写)
- substring:返回结果的文本包含指定字符串(区分大小写)
- 否: 取反
- 或者:如果存在多个测试模式,勾选代表逻辑或(只要有一个模式匹配,则断言就是 ok),不勾选代表逻辑与(所有都必须匹配,断言才是 ok)
-
测试模式:预期结果,即填写指定的结果(可填写多个) 按钮[添加]、[删除] 是进行指定内容的管理。
3.1.3 实战案例
检查百度首页的请求响应中是否包含"百度一下,你就知道"。
1. 步骤一:添加百度的 HTTP Request,添加对应的 Response Assertion,添加查看结果树。
如下图所示:
2. 步骤二:在 Response Assertion 元件中添加对应配置,
如下图所示:
3. 步骤三:查看结果如图所示:断言成功。
3.2 Size Assertion(大小断言)
3.2.1 简介
在 JMeter 中,Size Assertion 是一种断言元件,用于验证服务器响应的内容的大小是否符合预期。Size Assertion 允许您检查返回的响应数据的大小是否在指定的范围内,以便在性能测试中验证响应的大小是否符合要求。
3.2.2 参数配置介绍
- Apply to 选项默认即可,Main sample only(仅作用于父节点取样器)。
-
Response Size Field to Test:
- Full Response:完整响应
- Response Headers:响应头
- Response Body:响应的消息体,选择此项判断返回主题数据 Body 的大小
- Response Code:响应代码
- Response Message:响应信息
-
Size to Assert:
- size in bytes(字节大小):设置要判断的数值,单位 bytes/kb
- Type of Comparison(比较类型)
3.2.3 实战案例
检查百度首页的请求响应的内容大小是否大于等于 2381。
1. 步骤一:添加百度的 HTTP Request,添加对应的 Size Assertion,添加查看结果树。
如下图所示:
2. 步骤二:在 Size Assertion 元件中添加对应配置
如下图所示:
3. 步骤三:查看结果如图所示:断言成功。
3.3 XPath Assertion(XPath 断言)
3.3.1 简介
XPath Assertion 是 JMeter 中的一种断言元件,用于验证 XML 或 HTML 响应的内容是否符合指定的 XPath 表达式。XPath 是一种用于在 XML 文档中定位和选择元素的语言,通过 XPath Assertion,可以使用 XPath 表达式来验证响应中的特定内容,例如检查特定元素、属性或文本是否存在或符合条件。
3.3.2 参数配置介绍
-
XML Parsing Options (XML 解析选项)
- Use Tidy:当需要处理的页面是 HTML 格式时,必须选中该选项;如果是 XML 或 XHTML 格式(例如 RSS 返回),则取消选中,默认是 quiet;
- Quiet 表示只显示需要的 HTML 页面,
- Report errors 表示显示响应报错,
- Show warnings 表示显示警告;
- Use Namespaces:如果启用该选项,后续的 XML 解析器将使用命名空间来分辨;
- Validate XML:根据页面元素模式进行检查解析;
- Ignore Whitespace:忽略空白内容;
- Fetch external DTDs:如果选中该项,外部将使用 DTD 规则来获取页面内容。引用名称:下一个请求要引用的参数名称,如填写 title,则可用${ var_regexp2}引用它。 (一些 XML 元素具有属性,属性包含应用程序使用的信息,属性仅在程序对元素进行读、写操作时,提供元素的额外信息,这时候需要在 DTDs 中声明)
-
Xpath Assertion 用于填写 xpath 表达式,点击 Validate 验证其正确性,勾选 True if nothing matches 表示确认都不匹配,才会断言验证通过。
3.3.3 实战案例
检查百度首页的请求响应的内容包含 Xpath 表达式://input[@id="kw"]
1. 步骤一:添加百度的 HTTP Request,添加对应的 XPath Assertion,添加查看结果树。
如下图所示:
2. 步骤二:在 Xpath Assertion 元件中添加对应配置
如下图所示:
3. 步骤三:查看结果如图所示:断言成功。
3.4 JSON Assertion(Json 断言)
3.4.1 简介
JSON Assertion 是 JMeter 中的一种断言元件,用于验证 JSON 格式的响应数据是否符合预期。在进行 API 接口性能测试时,通常会返回 JSON 格式的响应数据,通过 JSON Assertion,可以根据预定义的 JSON 断言规则来验证返回的 JSON 数据是否正确。
3.4.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): 反转断言(如果满足以上条件则失败)
3.4.3 实战案例
检查天气请求响应的 JSON 数据中,city 对应的内容是否为'北京'。
步骤一:添加天气的 HTTP Request,添加对应的 JSON Assertion,添加查看结果树。
如下图所示:
步骤二:在 JSON Assertion 元件中添加对应配置
如下图所示:
步骤三:查看结果如图所示:断言成功。