网址:https://learning.getpostman.com/docs/postman/scripts/test-scripts/
测试脚本
您可以使用JavaScript为Postman API请求编写测试脚本。
通过测试,您可以确保API能够按预期运行,确定服务之间的集成可靠运行,并验证新开发是否没有破坏任何现有功能。
当您的API项目出现问题时,您还可以使用测试代码来帮助调试过程。
例如,您可以编写测试以通过发送不完整数据的请求来验证API的错误处理。
您可以将测试添加到单个请求,文件夹和集合中。邮递员提供的代码段可以单击添加,然后根据需要进行修改以适合您的逻辑。
要将测试添加到请求中,请打开请求,然后在“测试”选项卡中输入代码。测试将在请求运行后执行。您将能够在测试结果选项卡中的响应数据旁边看到输出。
编写测试脚本
您的测试脚本可以使用动态变量,对响应数据执行测试断言,并在请求之间传递数据。
在测试的请求选项卡,您可以手动输入您的JavaScript或使用片段,你会看到在代码编辑器的右侧。
测试将在收到响应后执行,因此,当您单击Send时,当响应数据从API返回时,Postman将运行您的测试脚本。
要执行测试以验证请求返回的数据,可以使用pm.response
对象。
您可以使用pm.test
函数定义测试,并提供一个名称和函数,该函数返回一个布尔值(true
或false
)来指示测试是通过还是失败。
您可以在声明中使用ChaiJS BDD语法pm.expect
来测试响应详细信息。
该.test
函数的第一个参数是文本字符串,它将出现在测试结果输出中,因此您可以使用它来识别测试,并将测试的目的传达给查看结果的任何人。
例如,在“ 测试”选项卡中为任何请求输入以下内容,以测试响应状态代码是否为200
。
pm.test("Status test", function () {
pm.response.to.have.status(200);
});
单击发送以运行您的请求,然后在响应部分中打开测试结果。选项卡标题显示通过了多少测试,总共运行了多少。
您还可以在通过,跳过和失败的测试结果之间切换。
如果请求返回了200
状态码,则测试将通过-否则将失败。尝试在测试脚本中更改预期的状态代码,然后再次运行请求。
使用pm.expect
语法可以为测试结果消息提供不同的格式-尝试使用其他方法来获得最有用的输出。
使用“ 简介”中的“在邮递员中运行”按钮来编写测试集合,以将包含一些示例测试脚本的模板导入Postman并进行代码试验。
您的代码可以测试请求环境,如以下示例所示:
pm.test("environment to be production", function () {
pm.expect(pm.environment.get("env")).to.equal("production");
});
您可以使用不同的语法变体以您认为可读的方式编写测试,并且适合您的应用程序和测试逻辑。
pm.test("response should be okay to process", function () {
pm.response.to.not.be.error;
pm.response.to.have.jsonBody("");
pm.response.to.not.have.jsonBody("error");
});
测试可以使用适合于响应数据格式的语法来确定请求响应的有效性。
pm.test("response must be valid and have a body", function () {
pm.response.to.be.ok;
pm.response.to.be.withBody;
pm.response.to.be.json;
});
您的脚本可以包含您需要的许多测试,并且在单击“ 保存”时将与您的其余请求详细信息一起保存。
如果您共享一个收藏集或发布文档/“在邮递员中运行”按钮,则查看或导入模板的任何人都将包含您的测试代码。
使用摘要
你会看到一个选择常用的测试代码摘录的片段,以测试编辑器的右侧。单击添加一个,它将出现在编辑器中。
代码段可以加快脚本入门的速度-您可以在添加代码段以满足自己的测试要求之后对其进行编辑。
测试集合和文件夹
您可以将测试脚本添加到集合,文件夹或集合中的单个请求中。与集合关联的测试脚本将在集合中的每个请求之后运行。
与文件夹关联的测试脚本将在文件夹中的每个请求之后运行。这样,您可以在每次请求后重用通常执行的测试。
将脚本添加到集合和文件夹后,您可以测试API项目中的工作流程。这有助于确保您的请求涵盖典型场景,从而为应用程序用户提供可靠的体验。
您可以通过单击集合或文件夹名称旁边的查看更多操作(...),然后选择编辑来更新集合和文件夹脚本。
选择“ 测试”选项卡以添加或更新脚本。您还可以在首次创建集合时添加集合脚本。
当你运行一个集合,你将看到由集合亚军输出的测试结果。
您可以编写脚本来使用分支和循环控制请求运行的顺序。