第 3 课

执行测试,查看 verdict 并下载步骤证据

运行已保存的测试,查看结果状态并下载测试证据。

图文21 分钟

课程目录第 3 / 3 课

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

图文教材

本课对照官方文档 CLI Quickstart 中「Run the saved test」和「Inspect the result」两节编写。对照 JSON 来自官方 CLI 0.17.0 的 --dry-run 罐头样例,场景是结账失败。真实运行的结论、选择器和录像地址都会不同。

本课目标

  • 用上一课保存的测试 ID,在 staging 环境执行并等待结论
  • 从运行结果里取出 runId 和 resultId
  • 用 result get 阅读 testStatus、error、cause 和 fix
  • 用 --out 把截图、页面快照和录像下载到本地目录

第 1 步:执行已保存的测试

官方命令如下。把 your-saved-test-id 换成 apply 返回的测试 ID:

TEST_ID='your-saved-test-id'
testsprite run "$TEST_ID" --env staging --wait --output json

官方说明:JSON 里 runs[].runId 标识这一次执行;产生结果的测试各有 results[].resultId。完整通过的执行退出码是 0;完整失败的执行退出码是 1,但仍会打印结果。若等待超时,用 testsprite run wait 继续跟踪。

本机罐头样例主要展示将要发出的请求,不会假装一次已经结束的真实运行:

testsprite --dry-run run "test_dryrun0001" --env staging --wait --output json

样例里可以看到请求路径和 dryRun 为 true。真实执行时,应等到 status 结束后再进入下一步。

第 2 步:列出这次执行的结果

RUN_ID='your-run-id'
testsprite result list --run "$RUN_ID"

本机罐头样例如下:

testsprite --dry-run result list --run "run_dryrun0001" --output json

节选:

{
  "run": {
    "runId": "run_dryrun0001",
    "status": "finished",
    "targetUrl": "https://staging.example.com/checkout"
  },
  "results": [
    {
      "resultId": "res_dryrun0001",
      "title": "Checkout happy path",
      "testStatus": "FAILED",
      "error": "AssertionError: expected the order confirmation heading to be visible",
      "environmentName": "staging"
    }
  ]
}

官方样例里同一 run 还包含 PASSED、BLOCKED 和 RUNNING 等不同 testStatus。阅读时先找你要审查的那一条 resultId。BLOCKED 表示测试未能开始,样例里的原因是登录失败。

第 3 步:查看单条结果并下载证据

官方文档给出的核心命令是:

RESULT_ID='your-result-id'
testsprite result get "$RESULT_ID" --output json

文档同时说明:这些字段是 CLI 的离线样例,可以用下面这条命令复现:

testsprite --dry-run result get res_dryrun0001 --output json

本机在 2026-11-22 用官方 CLI 0.17.0 执行了这条命令,标准错误提示 sample response — not from the server。输出节选如下:

{
  "resultId": "res_dryrun0001",
  "title": "Checkout happy path",
  "type": "FRONTEND",
  "testStatus": "FAILED",
  "error": "AssertionError: expected the order confirmation heading to be visible",
  "cause": "The submit button stays disabled because the card field is empty.",
  "fix": "Fill the card number before submitting the checkout form.",
  "failedStep": {
    "stepIndex": "3",
    "type": "assertion",
    "action": "visible",
    "description": "Expect the order confirmation heading",
    "status": "failed",
    "selector": "[data-testid=\"order-confirmation\"]",
    "url": "https://staging.example.com/checkout"
  }
}

官方说明:result get 成功只表示 CLI 读到了结果,真正的结论看 testStatus。若应用没有达到预期行为,先修应用、部署到 staging,再跑同一个测试 ID。若断言本身写错了,请项目智能体修改计划,审查后再 apply。

把证据下载到本地目录:

testsprite result get "$RESULT_ID" --out ".testsprite/results/$RESULT_ID"

官方文档写明:--out 会保留这条结果的详情,以及可用的录像、截图和页面快照。罐头样例里的 videoUrl 和截图地址带有 dryrun 字样,不能当真实文件打开。你用自己的密钥执行后,本地目录里应能看到对应证据。

完成本课即走完官方 Quickstart 的主路径:安装、规划、执行、查看证据。若还想在网页控制台里做同一件事,可对照官方 UI Quickstart;那条路径不写代码,大约 10 分钟,结束后每个测试都会留下录像。

官方文档中的新建项目界面

官方 Web Portal UI Quickstart 配图,展示新建项目时的「What should we test?」界面。来源:

https://docs.testsprite.com/web-portal/core/ui/quickstart