『政善治』Postman — 9.Pre-request Script的使用

Postman测试沙箱其实是结合JS脚本和内置断言函数,来完成测试中的断言功能,在请求发起前后实现部分测试操作。

常用功能:

  • 请求前脚本(pre-request scripts)设置请求前置操作如设置变吊等。
  • 请求后脚本(tests)对状态码、响应头、响应正文等信息进行断言操作。

1、Pre-request Script介绍

Pre-request Script是请求发送之前需要执行的代码片段。

提示:在一个请求或者一个集合都可以定义Pre-request Script,在集合中定义Pre-request Script,表示集合中的每一个请求发送前,都需要执行Pre-request Script中的js脚本。

作用或者需求:准备数据。

  • 请求参数中包含一个随机数。
  • 请求header中包括一个时间戳。
  • 请求参数需要加密。

等等。

点击请求中的Pre-request Script标签项,如下图:

我们可以在上图看到,在Pre-request Script标签页的右侧边栏中,Postman为我们提供了一些常用的代码模版。

提示我们:

Pre-request scripts are written in JavaScript.
and are run before the request is sent.
请求前脚本是用JavaScript编写的。
并在发送请求之前运行。

Learn more about pre-request scripts。
点击这里,可以学习更多关于pre-request scripts的资料。

这里学习关于pre-request scripts的更多用法:
https://learning.postman.com/docs/postman/scripts/pre_request_scripts/

2、常用SNIPPETS(片段)说明

(1)获取变量脚本:

  • Get an environment variable

    // 获取一个环境变量
    // 1.pm表示postman
    // 2.environment表示环境变量
    // 3.get表示获取
    pm.environment.get("variable_key");
    
  • Get a global variable

    // 获取一个全局变量
    pm.globals.get("variable_key");
    
  • Get a variable

    // 获取一个变量(本地)
    pm.variables.get("variable_key");
    
  • 获取集合变量的脚本

    var collectionVariable = pm.collectionVariables.get("variable_key");
    
  • 获取数据变量的脚本

    var iterationData = pm.iterationData.get("variable_key");
    

(2)设置变量脚本:

  • Set an environment variable

    // 设置一个环境变量
    // 1.pm表示postman
    // 2.environment表示环境变量
    // 3.set表示设置
    pm.environment.set("variable_key", "variable_value");
    
  • Set a global variable

    // 设置一个全局变量
    pm.globals.set("variable_key", "variable_value");
    
  • 设置一个变量(本地)

    pm.variables.set("variable_key", "variable_value");
    
  • 设置一个集合变量

    pm.collectionVariables.set("variable_key", "variable_value");
    
  • 设置一个数据变量

    pm.iterationData.set("variable_key", "variable_value");
    

(3)清空变量脚本:

  • Clear an environment variable

    // 清空一个环境变量
    // 1.pm表示postman
    // 2.environment表示环境变量
    // 3.unset表示清空
    pm.environment.unset("variable_key");
    
  • Clear a global variable

    // 清空一个全局变量
    pm.globals.unset("variable_key");
    
  • 其他的变量同理。

(4)Send a request

Postman提供了一个“Send a request”代码段,他是已经封装好的发送请求的方法

pm.sendRequest("https://postman-echo.com/get", function (err, response) {
    console.log(response.json());
});

// 其中,https://postman-echo.com/get表示要发送的请求。
// function中的err表示请求返回的错误信息,response表示响应内容。
// console.log()是postman封装的查看日志的方法,可以调出postman的console控制台来查看代码运行情况,方便调试。

注意:该代码段默认只能发送get请求,且这样直接使用的话无法指定请求头等信息,当然大部分情况下我们不需要单独指定一些请求信息,Postman可以自动帮我们完成准备工作。

示例:在Pre-request Script中自定义发送一个Post请求

// Pre-request Script 中的js代码
// 定义请求数据体
var data = {
    "userName":"admin",
    "password":"123456"
}

// 从环境变量中获取token请求服务地址
var ip = pm.environment.get("ip");
var port = pm.environment.get("port"); 

// 定义请求
const loginRequest = {
  //url: 'http://'+ ip+':'+ port +'/login',
  url: 'http://httpbin.org/post',
  method: 'POST',
  header: ['Content-Type:application/json', 'token:123456'],
  body: {
    mode: 'raw',
    raw: JSON.stringify(data)
  }
};

// 发送请求
pm.sendRequest(loginRequest, function (err, response) {
    console.log(response.json());
});

代码说明:

  • const:是js中用来定义变量的关键字,由const定义的变量不可以修改,而且必须初始化。

  • url:表示要发送的请求url。

  • method:指定请求方法。

  • header:定制请求头信息(很重要,因为你要传json格式的数据的话,需要在这里定义请求头为Content-Type:application/json)。

  • body:表示请求body中携带的参数。

  • JSON.stringify() 方法是将一个JavaScript值(对象或者数组)转换为一个JSON字符串。

  • 定义好const变量后再由sendRequest()来发送请求即可。

  • header的写法可以是:

    // 一条头信息
    header: 'Content-Type:application/json',
    
    // 多条头信息
    // 形式一
    header:[
              {"key1":"XXX","value1":"XXX"},
              {"key2":"XXX","value2":"XXX"}
            ]
    
    // 形式二
    header:[
             'key1:XXX',
             'key2:XXX'
         ]
    

(5)总结:

对于Postman中的变量管理,我们最好手动管理,也就是自己手动设置环境变量和全局变量,最好不用脚本来管理Postman中的变量。

参考:https://www.cnblogs.com/hanmk/p/10200887.html

3、示例1

我们以“新增学院”接口为例,如下图:

我们可以在Pre-request Script进行提交数据的准备。

编写如下JavaScript代码:

// 随机生成一个3位数字的id
var dep_id = Math.floor(Math.random()*1000);
pm.environment.set("depid" , dep_id); //设置到环境变量中

// 随机生成学院名称dep_name
// 随机生成一个10位的字符串
var data = Math.random().toString(36).slice(-10) ;
var dep_name = data+"学院";
pm.environment.set("dep_name" , dep_name);//设置到环境变量中

// 随机生成院长的名字
var first_name = ["赵","钱","孙","李","刘"];
var last_name = ["子鼠","丑牛","寅虎","牟兔","辰龙","巳蛇"];
var master_name = first_name[Math.floor(Math.random() * (first_name.length))] +last_name[Math.floor(Math.random() * (last_name.length))];
pm.environment.set("master_name" , master_name);//设置到环境变量中

// 随机生成口号
var slogan_str = ["吃饭","睡觉","打豆豆"];
var slogan = slogan_str[Math.floor(Math.random() * (slogan_str.length))];
pm.environment.set("slogan" , slogan);//设置到环境变量中

//代码很low,就是演示。

然后填写Post请求,以Json格式数据为例,参数中引用Pre-request Script脚本中添加到环境变量中的变量。

这样就能够完成自动生成数据,来完成接口的测试。

提示:

我们在实际工作中,不用这种方式准备数据,上面的例子只是说明Pre-request Script的作用。

在实际工作中,我们使用参数化来批量准备数据。

在接口测试中,有些参数是需要自动生成的,且这些参数并不参与逻辑关系。

比如说时间戳,并不会参与接口中的逻辑关系,只起到校验的作用。我们提交的时间戳参数,要和服务器的时间戳进行对比,比如我们上传的时间戳和服务器的时间戳不能超过5秒钟,如果超过5秒则不能请求成功。

所以我们需要在Pre-request Script中把时间戳生成,然后保存到环境变量中,最后再提交的参数中获取到环境变量中的刚刚保存的时间戳数据。(就如同上面步骤)

// js获取当前时间戳
// 第一种方法:(这种方法只精确到秒)
var timestamp = Date.parse(new Date()); //1613702922000

// 第二种方法:
var timestamp = (new Date()).valueOf(); //1613702956959

// 第三种方法:(推荐)
var timestamp = new Date().getTime(); //1613703043378

pm.environment.set("timestamp" , timestamp);//设置到环境变量中

请求头中所需要的数据也是一样的操作。

还有一点要提示的,如果在发送请求之后,提示js代码有错误,可以点击Postman下边框的Console控制台,来查看错误的详细信息。

4、示例2

同理,我们也可以在Body中使用其他的数据提交格式,来接收使用Pre-request Script定义在环境变量中的数据。

如下图:

你可能感兴趣的:(『政善治』Postman — 9.Pre-request Script的使用)