MeterSphere使用教程（1）-断言规则

目录

一、文本

二、正则

三、JsonPath

四、XPath

五、响应时间

六、脚本

---

断言规则用于判断请求结果是否符合预期，MeterSphere提供了如下6种断言方式：

一、文本

根据响应文本断言，可对 ResponseCode、ResponseHeaders、ResponseData 三部分数据进行断言。

选择要断言的响应部分，可对所选响应信息中的文本进行条件判断，如是否包含某个字符，是等于某个字符。

对响应状态码验证需勾选“忽略状态”，表示不管状态码本身代表的含义是否为通过，只要和断言一致就算通过，不一致就算不通过。如：

• 判断响应代码为400表示通过：选择ResponseCode，条件选择 “等于”，值填写 “400”，勾选最右侧的 “忽略状态” 。则响应状态码为400时，本条断言通过；不是400时，本条断言失败。
• 判断响应头信息中有Cookie表示通过：选择ResponseHeaders，条件选择 “包含”，值填写 “Cookie"。则ResponseHeaders里有 “Cookie” 字符串时，本条断言通过；不包含“Cookie” 字符串时，本条断言失败。
• 判断响应体中没有 “登陆成功” 信息表示通过：选择ResponseData，条件选择 “不包含”，值填写 “登陆成功”。则ResponseData里没有 “登陆成功” 字符串时，本条断言通过；有 “登陆成功” 字符串时，本条断言失败。

二、正则

同样是根据响应文本断言，与文本断言的区别是适用于更复杂的断言场景，可使用正则表达式对 ResponseCode、ResponseHeaders、ResponseData 三部分数据进行断言。

文本断言中的三个例子，使用正则断言的写法如下：

• 判断响应代码为400表示通过：选择ResponseCode，填写Perl型正则表达式 “^400$”，勾选最右侧的 “忽略状态” 。则响应状态码为400时，本条断言通过；不是400时，本条断言失败。
• 判断响应头信息中有Cookie表示通过：选择ResponseHeaders，填写Perl型正则表达式 “.*Cookie.*"。则ResponseHeaders里有 “Cookie” 字符串时，本条断言通过；不包含“Cookie” 字符串时，本条断言失败。
• 判断响应体中没有 “登陆成功” 信息表示通过：选择ResponseData，填写Perl型正则表达式 “(?s)^((?!登陆成功).)*$”。则ResponseData里没有 “登陆成功” 字符串时，本条断言通过；有 “登陆成功” 字符串时，本条断言失败。

三、JsonPath

JsonPath适用于返回值为json字符串的请求，可根据json路径对响应体中的对应的值进行判断。

填写JsonPath后，可选择对期望值进行 正则匹配、包含、不包含、等于、不等于 5种判断条件。

选择正则表达式即根据正则表达式判断JsonPath值是否符合预期，选择包含、不包含、等于、不等于则正常判断JsonPath值是否符合预期。

四、XPath

XPath适用于返回值为xml格式的请求，可根据XPath路径对响应体中的对应的值进行判断。选择XPath后，填写xpath表达式，如

• 判断响应中某节点的值为 “19.99” 表示通过：选择XPath，填写XPath表达式 “/根节点/子节点/子节点=“19.99”” 或 “/根节点/子节点/子节点[text()='19.99']“。则对应节点的值等于 “19.99” 时，本条断言通过；否则本条断言失败。

• 判断响应中某节点包含 “登陆成功” 信息表示通过：选择XPath，填写XPath表达式 “/根节点/子节点/子节点[contains(text(),'登陆成功')]”。则对应节点有 “登陆成功” 字符串时，本条断言通过；否则本条断言失败。

五、响应时间

用于对响应时间进行断言，响应时间在xxx毫秒内即断言通过，超时则断言失败。

六、脚本

对于复杂对断言，可用脚本编写断言规则，选择脚本，点击编辑可编辑断言脚本。

脚本编辑页面第一行的变量，可填写要断言的变量名和预期值，自动生成断言脚本。