这里写自定义目录标题
- Postman 使用
- Postman Console
- Postman Tests 使用
- 例子
- 校验接口响应的状态码, 常见的有 200、404、500 当然也包括前面鉴权学到的 401 等等。
- 检查响应信息中是否包含某些指定的字符串;
- 检查从 JSON 响应中获取到某个字段, 判断其是否与预期字段一致;
- 检查实际获取的响应体 (即 Body 信息) 与预期结果的响应体是否一致;
- 检查响应中的头域信息 (Headers) 是否与预期一致;
- 判断实际响应时间是否与低于预期时间
- 检查响应码是否与预期集合中的某个值一致
- 检查响应信息中是否包含某个预期值
- 转化 XML 格式的响应成 JSON 对象
- 设置环境变量
- 设置环境变量
- 设置全局变量
- 检查 response body 中是否包含某个 string
- 检测 JSON 中的某个值是否等于预期的值
- 转换 XML body 为 JSON 对象
- 检查 response body 是否与某个 string 相等
- 测试 response Headers 中的某个元素是否存在 (如: Content-Type)
- 验证 Status code 的值
- 验证 Response time 是否小于某个值
- name 是否包含某个值
- POST 请求的状态响应码是否是某个值
- 很小的 JSON 数据验证器
- 获取 request 值
- `JSON.parse()` 和 `JSON.stringify()`
- 判断字段值是否为空 `typeof()`
- 在 pre-request 和 tests 中获取变量的方法
- 定义一个变量在脚本中
- 取一个预定义的变量
- 设置一个变量在作用域中
Postman 使用
Postman Console
应用菜单 –>
View—>
Show Postman Console, 打印变量的值, 就可以在此窗口查看数据。
Postman Tests 使用
在 Tests 里面写 JS 语句, 如返回是下面的话:
{
"success": false,
"code": -3001,
"msg": "","tips": {"duration": 400,"limitMsg":" 前方拥挤, 请稍后再试。.."},"data": {}
}
为了检测 success
是否是 true
, 就这样写:
pm.test("success", function () {
var jsonData = pm.response.json();
pm.expect(jsonData.success).to.eql("true");
});
写完后, 点击左上角的 “Runner” 进入跑测试。
例子
pm.environment.get("variable_key");
pm.globals.get("variable_key");
pm.variables.get("variable_key");
pm.environment.set("variable_key", "variable_value");
pm.environment.unset("variable_key");
pm.globals.unset("variable_key");
pm.sendRequest("https://postman-echo.com/get", function (err, response) {
console.log(response.json());
});
校验接口响应的状态码, 常见的有 200、404、500 当然也包括前面鉴权学到的 401 等等。
pm.test("Status code is 200", function () {
pm.response.to.have.status(200);
});
检查响应信息中是否包含某些指定的字符串;
pm.test("Body matches string", function () {
pm.expect(pm.response.text()).to.include("string_you_want_to_search");
});
检查从 JSON 响应中获取到某个字段, 判断其是否与预期字段一致;
pm.test("Your test name", function () {
var jsonData = pm.response.json();
pm.expect(jsonData.value).to.eql(100);
});
检查实际获取的响应体 (即 Body 信息) 与预期结果的响应体是否一致;
pm.test("Body is correct", function () {
pm.response.to.have.body("response_body_string");
});
检查响应中的头域信息 (Headers) 是否与预期一致;
pm.test("Content-Type is present", function () {
pm.response.to.have.header("Content-Type");
});
判断实际响应时间是否与低于预期时间
pm.test("Response time is less than 200ms", function () {
pm.expect(pm.response.responseTime).to.be.below(200);
});
检查响应码是否与预期集合中的某个值一致
pm.test("Successful POST request", function () {
pm.expect(pm.response.code).to.be.oneOf([201,202]);
});
检查响应信息中是否包含某个预期值
pm.test("Status code name has string", function () {
pm.response.to.have.status("Created");
});
转化 XML 格式的响应成 JSON 对象
var jsonObject = xml2Json(responseBody);
设置环境变量
http://{{host}}:{{port}}/api/tong
在实现接口自动测试的时候, 会经常遇到接口参数依赖的问题, 例如调取登录接口的时候, 需要先获取登录的 key 值, 而每次请求返回的 key 值又是不一样的, 那么这种情况下, 要实现接口的自动化, 就要用到 postman 中设置环境变量这个功能了;
在 postman 中, 可以利用 tests 将接口返回的 response 设置为环境变量, 供后续接口使用 (类似参数化的概念)
获取环境变量需要具体方法如下图所示;
var jsonData =JSON.parse(responseBody);// 获取 body 中返回的所有参数
postman.setEnvironmentVariable("appKey",jsonData.data.appKey);// 把返回参数中的 keys 设置为环境变量
设置环境变量
postman.setEnvironmentVariable("key", "value");
pm.environment.get("key", "value");//postman 5.0 以上版本设置环境变量的方法
设置全局变量
postman.setGlobalVariable("key", "value");
pm.globals.set("variable_key", "variable_value");//postman 5.0 以上版本设置全局变量方法
检查 response body 中是否包含某个 string
tests["Body matches string"] = responseBody.has("string_you_want_to_search");
pm.test("Body is correct", function () {
pm.response.to.have.body("response_body_string");
});//5.0 以上版本方法
检测 JSON 中的某个值是否等于预期的值
var data = JSON.parse(responseBody);
tests["Your test name"] = data.value === 100;
JSON.parse()
方法, 把 json 字符串转化为对象。parse()
会进行 json 格式的检查是一个安全的函数。
如: 检查 json 中某个数组元素的个数 (这里检测 programs 的长度)
var data = JSON.parse(responseBody);
tests["program's lenght"] = data.programs.length === 5;
转换 XML body 为 JSON 对象
var jsonObject = xml2Json(responseBody);
tests["Body is correct"] = responseBody === "response_body_string";
检查 response body 是否与某个 string 相等
测试 response Headers 中的某个元素是否存在 (如: Content-Type)
//getResponseHeader() 方法会返回 header 的值, 如果该值存在
tests["Content-Type is present"] = postman.getResponseHeader("Content-Type");
tests["Content-Type is present"] = responseHeaders.hasOwnProperty("Content-Type");
上面的方法, 不区分大小写。下面的方法, 要区分大小写。
验证 Status code 的值
tests["Status code is 200"] = responseCode.code === 200;
pm.test("Status code is 200", function () {
pm.response.to.have.status(200);
});//5.0 以上版本方法
验证 Response time 是否小于某个值
tests["Response time is less than 200ms"] = responseTime < 200;
//5.0 以上版本方法
pm.test("Response time is less than 200ms", function () {
pm.expect(pm.response.responseTime).to.be.below(200);
});
name 是否包含某个值
tests["Status code name has string"] = responseCode.name.has("Created");
//5.0 以上版本方法
pm.test("Status code name has string", function () {
pm.response.to.have.status("Created");
});
POST 请求的状态响应码是否是某个值
tests["Successful POST request"] = responseCode.code === 201 || responseCode.code === 202;
//5.0 以上版本方法
pm.test("Successful POST request", function () {
pm.expect(pm.response.code).to.be.oneOf([201,202]);
});
很小的 JSON 数据验证器
var schema = {
"items": {
"type": "boolean"
}
};
var data1 = [true, false];
var data2 = [true, 123];
console.log(tv4.error);
tests["Valid Data1"] = tv4.validate(data1, schema);
tests["Valid Data2"] = tv4.validate(data2, schema);
获取 request 值
var Json = JSON.parse(request.data);
- data {object}:
this is a dictionary of form data for the request. (request.data[“key”]==“value”) - headers {object}:
this is a dictionary of headers for the request (request.headers[“key”]==“value”) - method {string}:
GET/POST/PUT etc. - url {string}:
the url for the request.
假设 requestBody 中有 “version”:“1.0”; 这个值, 如果想获取到 version 的 value 值, 代码如下
var Json = JSON.parse(request.data);
var version = Json["version"];
JSON.parse()
和 JSON.stringify()
JSON.parse() [从一个字符串中解析出 json 对象] -- 把 string 转对象
JSON.stringify() [从一个对象中解析出字符串, 主要针对 [object object] 类型数据的转换] -- 把对象转 String
var data={name:'goatling'}
JSON.parse(data)
结果是: '{"name":"goatling"}'
JSON.stringify(data)
结果是: name:"goatling"
判断字段值是否为空 typeof()
var Jsondata = JSON.parse(responseBody);
if( typeof(Jsondata.data) != "undefined" )
在 pre-request 和 tests 中获取变量的方法
变量可以被使用在 pre-request 和 test script 中。因为这些部分是通过 JavaScript 来写的
你可以以不同的方式初始化和检索这些变量。可以在脚本中初始化变量, 并将它们放在特定的范围内
定义一个变量在脚本中
在脚本中设置一个变量可以根据变量预定的范围通过 pm.environment.set("variable_key", "variable_value");
方法或者 pm.globals.set("variable_key", "variable_value");
方法, 这方法要求提供变量的 key 和 value 去设置变量。当你发送请求的时候, 这脚本将会执行, 值将会保存在变量中, 如下图:
取一个预定义的变量
一旦一个变量被设置, 你可以使用 pm.environment.set("variable_key", "variable_value");
或者 pm.globals.set("variable_key", "variable_value");
根据适合的范围去获取变量值。这方法要求提供一个变量名作为参数去检索储存的值, 如下图:
设置一个变量在作用域中
可以访问环境变量在相应的环境模板。全局变量可以广泛的访问, 不管选择的作用域