Postman 的 Scripts、Tests 与 Collection Runner

理解 pre-request scripts、tests 和 Collection Runner 如何把 Postman 变成 API 自动化测试框架。

#tech / dev / api #type / synthesis #status / growing #resource / postman

[!info] related notes

Postman 的 Scripts、Tests 与 Collection Runner

范围

这篇笔记解释 Postman 怎样从手动调接口扩展成自动化测试执行器。

为什么要放在一起理解

单独看:

  • scripts 像脚本能力
  • tests 像断言能力
  • runner 像批量执行器

但它们真正的价值在于共同构成一条自动化链路:

request -> pre-request -> response -> tests -> batch run

依赖路径 / 调用链 / 演进链

1. Pre-request scripts

常见用途:

  • 生成签名
  • 获取或刷新 token
  • 预先设置变量
  • 动态构造 body

2. Tests

响应回来后,通常会:

  • 断言状态码
  • 校验 JSON 结构
  • 保存响应字段到 environment / collection variables
  • 把一个请求的输出喂给下一个请求

3. Collection Runner

Runner 把单个请求变成整套执行流程,适合:

  • 冒烟测试
  • 回归测试
  • 数据驱动测试
  • login -> create -> verify 这类多步骤流程

对比与易混淆点

Runner 不等于 CLI

  • Runner 更偏本地或工作台里的批量执行
  • CLI 更偏终端与 CI/CD 集成

tests 不只是“看 200”

它更重要的作用是把 collection 变成可执行验收资产。

Postman 的 scripts 不是通用测试框架替代品

它非常适合 API 工作流内的断言与串联,但复杂业务级测试仍可能需要更完整的代码测试栈。

创建于 2026/4/26 更新于 2026/5/27