JSONPath 在线测试

输入 JSONPath 表达式实时查询 JSON 数据,列出每个匹配结果的值和完整路径。支持递归查找、通配、切片和条件过滤,下方有常用示例和语法速查,方便在 Postman、JMeter 等接口测试工具中写提取和断言表达式。数据只在浏览器本地处理。

JSONPath 语法速查

写法含义示例
$根节点$
.key、['key']子属性,键名有特殊字符时用方括号$.store['coupon-code']
..递归查找所有层级$..author 所有作者
*通配,所有属性或元素$.store.*
[n]、[-1]数组下标,负数从末尾数$.store.book[-1] 最后一本
[a,b]多个下标或属性$.store.book[0,2]
[start:end:step]切片,不包含 end$.store.book[0:2] 前两本
[?(条件)]过滤,@ 表示当前元素$..book[?(@.price < 20 && @.tags)]
@.length数组长度(JavaScript 实现支持)$..book[(@.length-1)]
  • 不同实现有差异:JSONPath 在 2024 年才有正式标准(RFC 9535),之前各工具的实现不完全一致。本页使用 jsonpath-plus,条件过滤可以写 JavaScript 表达式;Java 的 Jayway JsonPath(JMeter、Spring 使用)支持 =~ 正则和 in、size 等运算符,写法略有不同。
  • Postman 中使用:Postman 的测试脚本是 JavaScript,可以直接写 pm.response.json().store.book[0].title;JMeter 的“JSON 提取器”和“JSON 断言”使用 JSONPath 表达式。

浏览数据结构、复制节点路径可以用 JSON 树形查看器。

JSONPath 在线测试常见问题

JSONPath 在线测试怎么使用?

在上方输入 JSONPath 表达式,或点击示例按钮,下方左侧是 JSON 数据,右侧实时显示匹配的结果和路径,可以切换为 JSON 数组形式复制。

JSONPath 是什么?

一种从 JSON 中按路径和条件提取数据的查询语言,类似于 XML 的 XPath。

怎么筛选数组中的元素?

使用 [?(@.字段 条件)],例如 $..book[?(@.price < 20)]。

$.. 是什么意思?

递归查找所有层级中的指定字段。

JMeter 中怎么用 JSONPath?

在“JSON 提取器”中填写表达式,提取到的值可以在后续请求中通过变量使用。

JSONPath 在线测试的结果应怎样理解?

使用 jsonpath-plus 实现,过滤表达式按安全模式执行;与 Java 的 Jayway JsonPath 在少数写法上有差异。

输入内容会保存或发给外部服务吗?

JSON 数据只在浏览器本地查询,不会上传。

没有结果或操作失败时先检查什么?

没有匹配结果时,检查表达式是否以 $ 开头、键名大小写是否一致;键名包含连字符等特殊字符时用 ['键名'] 写法。

相关工具

JSON 树形查看器 · WebSocket 在线测试 · JSON 格式化校验 · Base64 编码解码 · 全部开发工具