跳到主要内容

使用集合运行程序（Collection Runner）

Collection Runner使你能够以指定的顺序运行集合的请求。它记录你的请求 测试结果 ，并可以使用 脚本 在请求之间传递数据并更改请求工作流程。

你可以配置 Collection Runner 以满足你的开发需求。你可以使用特定环境运行集合，并将数据文件传递到运行中。 Collection runs 使你能够自动化 API 测试，并且你可以安排运行以使用 Collection Runner 或 监视器 在 Postman 云中运行。 你还可以使用 Postman CLI 将集合运行与 CI/CD 管道集成，Postman 工具使你能够直接从命令行运行和测试集合。

配置 collection run​

  1. 在边栏中选择Collections，然后选择你要运行的 Collection。

  2. 在概览选项卡上，选择 亚军图标 运行。

    从集合概览中选择运行

    你还可以从 Postman 页脚中选择 亚军图标 Runner ，然后从侧边栏的收藏或历史中拖动一个收藏。

  3. 选择手动运行。

    你还可以 使用 CLI 安排运行 和自动运行。

  4. 如果你希望你的收藏与环境一起运行，请使用 Postman 右上角的环境选择器选择它。你还可以在边栏中选择环境，然后选择你要使用的环境。

  5. 选择任何配置选项：

    • 迭代次数- collection run 的迭代次数。你还可以使用不同的数据集多次运行集合以 构建工作流 。
    • 延迟- 每个请求之间的间隔延迟（以毫秒为单位）。
    • 数据-collection run 的 数据文件。
    • 保留会话的响应- 记录响应 header 和正文，以便你可以在运行收集后查看它们。对于大型集合，持久响应可能会影响性能。

    请求和响应详细信息在你当前的 Postman 会话期间保留在本地，不会永久保存。注销 Postman、使用同一帐户登录另一台设备或刷新浏览器将结束你的会话并删除记录的数据。

    • 高级设置
      • 发生错误时停止运行- 默认情况下，如果在脚本中遇到异常或发送请求时出现问题，collection run 将停止。如果你希望在发生错误后继续运行收集，请清除此复选框。
      • 保留变量值- 保留运行中使用的变量，以便运行更新的任何变量在运行完成后保持更改。如果你不保留变量，则在运行完成后不会保存更改。请注意，collection run 中的持久化变量将仅更新当前值。
      • 在不使用存储的 cookie 的情况下运行收集- 如果你的请求使用 cookie，你可以选择停用它们以进行 collection run。
      • collection run 后保存 cookie - 将此会话中使用的 cookie 保存到 cookie 管理器。运行期间请求更改的任何值将在运行完成后保留。

  6. 默认情况下，你的请求按照它们在集合中列出的顺序运行。如果你需要更改执行顺序，请选择请求并将其拖动到顺序中的新位置。你还可以通过清除其名称旁边的复选框从运行中删除单个请求。

    setNextRequest你可以使用创建 工作 流来更改请求脚本的执行流程。

  7. 完成配置后，选择Run (collection name)。

集合运行器配置

你的 Postman plan 为你提供了每个月可以使用的有限次数的托收服务。此限制适用于你在工作空间或便签本中使用“手动运行”选项运行的集合。此限制不适用于 Postman 云中的 计划 collection run。 具有多次迭代的 collection run 算作一次运行。

当你接近使用限制时，Collection Runner 中将显示一条消息。详细了解 Postman 中的 资源使用 情况。

调试运行结果​

手动运行集合时，Postman 会实时显示你的请求执行结果和测试结果。你可以查看 collection run 的来源、所选环境、迭代次数、总持续时间、测试次数和平均响应时间。

Collection Runner 结果

要详细了解 collection run 期间发生的情况，请执行以下任一操作：

  • 选择一个请求以查看有关该请求的详细信息。你可以查看有关请求以及请求 header 和正文的一般信息。 如果你在配置 collection run 时选择了 Persist responses for a session选项，你还可以查看响应头和正文。
  • 选择请求的名称以在新选项卡中打开请求。你可以查看任何测试脚本或选择“发送”再次发送请求。
  • 选择Passed、Failed或Skipped选项卡以按测试状态过滤结果。要显示所有请求，请选择“所有测试”选项卡。如果在 collection run 期间请求脚本中的任何测试失败，则整个请求将失败。
  • 如果你的 collection run 包括多次迭代，请选择一个迭代编号以跳转到特定迭代的结果。
  • 选择查看所有运行以查看过去运行的列表。了解有关 查看运行历史记录 的更多信息。
  • 选择查看摘要以查看 collection run 的摘要，包括测试结果。要返回完整结果，请选择查看结果。

Collection Runner 总结

查看运行历史​

每个收集都有一个运行选项卡，显示过去和计划的 collection run。“运行”选项卡还显示测试计数和指标，例如持续时间和平均响应时间。

collection run历史选项卡

Runs 选项卡包括另外两个选项卡：Past runs**和**Scheduled runs。

过去的运行选项卡​

Past runs选项卡具有选择要查看的 collection run 次数的控件，并将显示的运行限制为来自选定用户、选定状态以及来自 Collection Runner 或 Postman CLI 的运行。

每次 collection run 都会显示以下内容：

  • 每次运行的复选框和选择所有运行的选项。
    • 选择一个或多个 collection run 并选择删除以删除它们。
  • collection run 的开始时间。
  • 运行源、持续时间、所有测试、通过的测试、失败的测试、跳过的测试和平均响应时间。选择这些项目中的任何一项以按该项目对表格进行排序。再次选择以更改排序顺序。

将鼠标悬停在项目上以显示以下控件：

  • 查看报告- 选择以打开 collection run 的完整结果。了解有关 调试运行结果的 更多信息。
  • 分享- 选择与其他团队成员分享结果。这提供了一个链接，你可以将其提供给其他团队成员，以便他们可以查看此运行的详细信息。请注意，这在个人工作空间中不起作用。

计划运行选项卡​

计划运行选项卡显示当前集合的所有计划运行。为每个计划的运行显示以下内容：

  • 即将到来的运行的预定时间
  • 计划运行的名称
  • 与预定运行关联的环境（如果有）

将鼠标悬停在项目上以显示以下控件：

共享 collection run​

你可以通过从 Collection Runner 导出结果来与其他人共享集合运行结果。

导出结果按钮在 Postman 桌面应用程序中可用，但在 Web 版本中不可用。

要导出集合运行，请执行以下操作：

  1. 在 Runner中打开集合运行。如果你没有打开运行，你还可以使用侧边栏中的历史记录访问 collection run。
  2. 选择右上角的导出结果以下载运行。
  3. 选择一个位置来保存你下载的集合运行，然后选择保存。

自动化 collection run​

除了手动运行集合之外，Collection Runner 还使你能够 安排集合 在 Postman 云中的指定时间自动运行。你还可以将 collection run 与其他 Postman 实用程序结合使用，以将自动化构建到你的 API 项目中。

  • Postman CLI 命令行界面使你能够运行集合并将它们构建到你的开发管道中，响应测试结果以支持你的 API 性能。
  • Newman 界面还使 你 能够从命令行运行集合。
  • 将 监视器 添加到你的集合可以让你安排集合运行并随时了解任何问题。
  • 你还可以设置一个 收集 webhook， 以使用你自己的自定义有效负载在特定时间触发 collection run。

下一步​

使用你学到的 Collection Runner 基础知识通过工作流扩展其功能。

  • 要了解如何使用脚本构建具有条件序列的工作流以运行集合中的请求，请访问 构建请求工作流 。