DiagramPreview
基础解析无需 AI本地预览可导出调试友好

JSONPath 测试器

粘贴 JSONPath 表达式和 JSON 响应,检查命中值、结果类型和可复制输出,适合 API 调试。

示例
JSONPath 命中结果就绪
预览结果会显示在这里。

下一步可以继续

把当前预览结果带到相关工具里继续转换、排查或导出。

使用方法

  1. 1粘贴有代表性的 JSON payload,并把第一行写成 JSONPath 表达式。
  2. 2通过邮箱提取、订单金额、递归 duration 等示例理解输入格式。
  3. 3复制到测试或文档前,先检查匹配数量、首个匹配值和结果表。
  4. 4如果没有匹配,逐段简化表达式,确认从哪一层开始失败。

常见场景

API 响应调试Webhook payload review测试断言设计AI JSON 输出校验嵌套数组检查

常见问题

为什么 JSONPath 没有匹配结果?

常见原因是缺少根选择器、数组层级需要 [*]、字段名拼错,或者真实 payload 结构和写表达式时用的示例不同。

复杂 JSONPath 怎么调试?

先从 $ 或顶层字段开始,每次只增加一个路径段,确认匹配数量后再加过滤器或递归选择器。

这能替代生产 JSONPath 库吗?

不能。它是预览和 review 界面,最终行为仍应使用项目里的 JSONPath 库和测试来确认。

JSONPath Tester 用来检查 API 响应、fixture、webhook payload 和 AI 生成 JSON,不需要临时写脚本。

预览会显示匹配值、结果形态和表格,帮助你确认表达式是否选中了期望字段。

它适合设计测试断言、检查监控 payload、准备文档示例,以及调试嵌套数组里容易选多或选空的路径。

Demo:从嵌套 API 响应提取用户邮箱

实用的 JSONPath review 应该使用接近生产结构、但脱敏后的 payload。预览匹配值和结果表后,再把表达式写进测试断言。

  • 字段可能出现在不同层级时,可以先用 $..email 探索。
  • 结构稳定时,用 $.users[*].email 这类严格路径。
  • 测试里优先用严格路径,探索时才使用递归路径。
$.users[*].email
{
  "users": [
    {"id": 1, "email": "ada@example.com"},
    {"id": 2, "email": "grace@example.com"}
  ]
}

第一行是表达式,后面是要检查的 JSON payload。

Code review 前值得提前发现的 JSONPath 问题

JSONPath 看起来正确,也可能选中了错误层级。预览结果能让这些问题在进入测试或文档前暴露出来。

  • 递归选择器可能匹配到无关对象里的同名字段。
  • [0] 这类数组索引依赖顺序,示例不一定代表生产数据。
  • 过滤器应该同时用命中和不命中的记录测试。

JSONPath 测试器 检查清单

当你需要在文档、PR、故障复盘或交接材料发布前检查源码内容时,可以使用 JSONPath 测试器。针对 API 响应运行常见 JSONPath 表达式,并查看匹配值。

导出前建议检查标签是否可读、关系是否和源码一致、示例是否包含敏感信息,以及修改输入后预览是否仍然成立。

限制与排查

如果预览失败,先把输入缩小到最小完整示例,确认格式语法,再逐段加回内容。很多失败来自不完整文件、缩进错误、缺少图表头,或复制了依赖隐藏上下文的片段。

请把预览结果当作 review 界面,而不是生产事实来源。生成的图表、转换文件、看板和规则示例在进入正式文档或运维流程前仍需要人工确认。

可测试的示例输入

  • 用户邮箱: $.users[*].email --- { "users": [ {"id": 1, "email": "ada@example.com", "role": "admin"}, {"id": 2, "email": "lin@example.com", "role": "viewer"} ] }
  • 首个订单总额: $.orders[0].total --- { "orders": [ {"id": "ord_1", "total": 49.9}, {"id": "ord_2", "total": 19.5} ] }
  • 递归耗时: $..durationMs --- { "trace": { "durationMs": 340, "spans": [{"name": "api", "durationMs": 120}, {"name": "db", "durationMs": 180}] } }

工具完成度

基础解析

基础解析

这个工具偏向快速结构检查,适合预览、排查和定位问题;关键输出进入生产前仍需要人工复核。

分级不是质量打分,而是告诉用户当前工具更适合稳定导出、深度调试、快速解析,还是 AI 辅助生成。