什么是Postman脚本，它能解决什么问题

Postman提供了两个脚本执行入口：Pre-request Script（请求前脚本）和Tests（请求后脚本）。两者都基于JavaScript语言，运行在Postman内置的沙箱环境中。

Pre-request Script在请求发送之前执行，典型用途是动态生成时间戳、签名、Token等参数。Tests在收到响应之后执行，用于校验状态码、检查返回字段、提取数据并写入环境变量。

举一个最直观的例子：你有一组接口需要登录后才能调用。手动操作时，你需要先调用登录接口、复制返回的Token、粘贴到下一个请求的Header中。而通过Postman脚本编写，你可以在登录接口的Tests中自动提取Token并存入环境变量，后续所有请求通过 `{{token}}` 直接引用，整个流程一键完成。

Postman从v10版本开始全面支持基于`pm.*` API的脚本体系（当前最新版本为v11.x），脚本能力持续增强，包括对`pm.sendRequest()`发起额外请求的支持，使得复杂的链式调用成为可能。

Postman脚本编写的语法基础与核心API

掌握以下几个核心对象，就能覆盖绝大多数Postman脚本编写场景：

`pm.environment.set(key, value)` / `pm.environment.get(key)` — 读写环境变量，是接口间传递数据的主要方式。

`pm.response.json()` — 将响应体解析为JSON对象，方便后续取值。

`pm.test(name, callback)` — 定义一个测试用例，配合`pm.expect()`进行断言。

下面是一段实用的Tests脚本示例，用于验证登录接口并提取Token：

```javascript pm.test("状态码应为200", function () { pm.response.to.have.status(200); });

var jsonData = pm.response.json();

pm.test("返回数据包含token字段", function () { pm.expect(jsonData.data).to.have.property("token"); });

pm.environment.set("token", jsonData.data.token); ```

Pre-request Script中动态生成时间戳的写法同样简洁：

```javascript pm.environment.set("timestamp", Date.now().toString()); ```

设置完成后，在请求参数中使用 `{{timestamp}}` 即可引用。这种变量机制让Postman脚本编写的灵活性远超手动填写。

两个实战场景：签名生成与接口健康检查

场景一：API签名动态生成。许多开放平台要求请求携带基于密钥和时间戳计算的签名。在Pre-request Script中完成这一逻辑：

```javascript var timestamp = Date.now().toString(); var secretKey = pm.environment.get("secret_key"); var sign = CryptoJS.MD5(secretKey + timestamp).toString();

pm.environment.set("timestamp", timestamp); pm.environment.set("sign", sign); ```

Postman沙箱内置了CryptoJS库，支持MD5、SHA256等常见算法，无需额外安装。请求URL或Header中直接使用 `{{sign}}` 和 `{{timestamp}}` 即可。

场景二：批量接口健康检查。将多个接口放入一个Collection，为每个请求的Tests添加统一的状态码断言：

```javascript pm.test("接口可用性检查", function () { pm.expect(pm.response.code).to.be.oneOf([200, 201]); pm.expect(pm.response.responseTime).to.be.below(2000); }); ```

然后通过Collection Runner批量执行，一次性检查所有接口的可用性和响应时间是否在2秒以内。如果某个接口超时或返回异常状态码，测试结果会直接标红，定位问题一目了然。

脚本调试与常见故障排查

Postman脚本编写过程中遇到问题，可以从以下几个方向排查：

使用 `console.log()` 输出变量值，在Postman底部的Console面板（快捷键 Ctrl+Alt+C / Cmd+Option+C）中查看。这是最直接的调试手段。

常见故障一：`TypeError: Cannot read property 'xxx' of undefined`。这通常意味着响应体结构与预期不符。先在Console中打印 `pm.response.json()` 确认实际返回结构，再调整取值路径。

常见故障二：环境变量未生效。检查三点——当前是否选择了正确的环境（Postman右上角下拉框）、变量名拼写是否一致、`set` 操作是否在 `get` 之前的请求中执行过。可以点击环境变量的"眼睛"图标快速查看当前值。

另外，脚本中避免使用浏览器特有的API（如 `document`、`window`），Postman沙箱不支持这些对象，调用会直接报错。

总结

Postman脚本编写的核心价值在于将重复的手动操作转化为可复用的自动化流程。从动态参数生成到响应断言，从单接口调试到批量健康检查，脚本能力让Postman从一个简单的请求发送工具进化为完整的API测试平台。

建议从最简单的状态码断言开始练习，逐步尝试环境变量传递和Pre-request Script，遇到问题善用Console面板调试。如果你还没有安装最新版Postman，前往官方下载页面获取v11版本，体验完整的脚本编写功能，开始构建你的第一个自动化测试集合。

相关阅读：Postman脚本编写使用技巧，Postman Interceptor下载与安装