运行器

运行器逐个发送请求，并告诉你哪些通过了。请求得到应答，而且来自它的测试标签页和脚本的每项检查都成立，才算通过。用它在改动之后试遍整个 API， 用多种输入运行同样的请求，或生成报告。

开始运行Copy Anchor Link

有几种入口：

• 在边栏中右键点按某个文件夹并选取 运行文件夹，或右键点按某个请求并选取 运行请求。运行会立即开始，并打开运行器页面。
• 在边栏中选中几个文件夹或请求，右键点按它们并选取 运行 N 个项目。
• 在命令面板中选取 运行工作区。
• 打开运行器页面，设置好运行并选取 运行。运行器在边栏的 测试 下，也可以选取 视图 › 运行器（⌥⌘R）。

在运行器页面上，运行 卡片包含各项设置：

选取 运行（⌘R）开始，选取 停止（⌘.）提前结束运行。当受保护的环境处于启用状态时，按钮显示 在 Production 中运行…（带该环境的名称）， 运行在发送任何内容之前会先询问。见受保护的环境。

运行什么，以及顺序Copy Anchor Link

请求按它们在边栏中的顺序运行：文件夹中的请求从上到下，其中的子文件夹就在原位置。每个请求都与你自己发送时完全一样：同样的变量、认证、脚本和检查。 之后的请求可以使用同一次运行中先前请求的响应，方式是通过响应值，以及由脚本或捕获设置的变量。例如，运行 Alpenglow 工作区时， 会先发送 Auth › Sign in，它捕获 Orders 请求所发送的令牌。

每种请求都可以运行：

• HTTP、GraphQL 和 gRPC 请求以及 MCP 调用，与其他请求一样被发送和检查。
• WebSocket、Socket.IO 和 MQTT 请求会连接，发送已为运行开启的已存储消息、事件或发布（MQTT 还会订阅它已启用的过滤器），监听 10 秒，然后关闭。消息日志就是响应， 所以对 正文 的检查也适用于它。要监听不同的时长，请在请求文件的 [settings] 中设置 stream-limit（单位为秒）。
• 服务器发送事件流会保持 10 秒，然后结束。

请求前脚本可以用 pm.execution.skipRequest() 跳过某个请求；结果会显示 已被请求前脚本跳过。脚本也可以用 pm.execution.setNextRequest("Request name") 跳转， 并用 pm.execution.setNextRequest(null) 结束运行。一直往回跳转的运行，会在一次迭代中发送 10,000 次之后被停止。

迭代和数据文件Copy Anchor Link

迭代 把所有内容运行这么多次。{{$uuid}} 之类的 {{$…}} 值每次都是新的，而 pm.info.iteration 表明当前是第几次迭代（从 0 开始）。

数据文件让运行由数据驱动：每一行对应一次迭代，每一列是一个变量，请求可以像使用其他变量一样使用它，例如 {{sku}}。脚本用 pm.iterationData.get("sku") 读取这一行。

• CSV：一个包含变量名称的表头行，之后每次迭代一行。引号、成对的引号以及引号内的换行都可以使用。
• JSON：对象数组，每次迭代一个对象。

例如，对于发往 {{baseURL}}/products/{{sku}}、并检查 $.sku 等于 {{sku}} 的请求，skus.csv 如下：

sku,quantity
TNT-MH-2P,1
PCK-TIT-30,2

或者同样的内容写成 JSON：

[
  { "sku": "TNT-MH-2P", "quantity": 1 },
  { "sku": "PCK-TIT-30", "quantity": 2 }
]

数据 字段显示文件的名称和它的行数。旁边的叉号会移除该文件。

并行迭代Copy Anchor Link

迭代多于一次时，同时运行 会并排运行多次迭代。同一次迭代内的请求仍保持顺序，而且每次迭代保留它自己脚本所设置的变量，所以一次迭代的令牌绝不会泄漏到另一次迭代中。 当迭代之间互相依赖，或服务器限制调用速度时，请把它保持在 1（逐个运行）。

重试、延迟和停止Copy Anchor Link

• 重试次数 会把失败的请求再发送一遍，最多这么多次。请求没有得到应答或某项检查失败，就算失败。结果会显示用了多少次尝试，例如 3 次尝试，并保留最后一次。
• 延迟 在请求之间等待，适用于有速率限制的服务器，例如演示 API。
• 首次失败时停止 在某个请求失败（重试之后）时结束运行。摘要随后显示 因失败而停止。

结果Copy Anchor Link

运行期间，列表会逐步填充，并显示正在发送的请求。它上方是各项计数：请求、通过、失败、失败的检查，结束时还有 时长，以及 全部通过 或 N 项失败。

每一行显示请求的类型或方法、名称和地址、状态以及耗时。有多次迭代时，#2 表明这一行属于哪次迭代。失败的请求下方是失败的检查，每项都带有它的消息，或没有响应的原因。点按某一行可打开该请求。

窗口打开期间，页面会保留最近一次运行。运行的每次交换也都在历史记录中，并标记为来自运行器。

报告Copy Anchor Link

运行之后，在 结果 卡片中点按 存储报告 可将其存储为文件：

JUnit、JSON 和 HTML 报告会遮蔽其中所含的地址、检查值和消息、脚本测试以及日志里的机密。

通过命令行运行Copy Anchor Link

echolot run 用同样的设置运行同一个工作区，用于 CI 和终端：迭代、数据文件、延迟、重试、并行迭代以及同样的报告格式。见 echolot run 和在 CI 中运行。