JSONPath 测试器

实时测试 JSONPath 表达式,查看匹配结果并高亮显示。支持过滤器、通配符和递归下降。免费,基于浏览器。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
表达式以 $ 开头。任一输入变化都会查询。支持 RFC 9535 的通配符、负索引、切片和过滤器;语法错误或不支持的语法会显示字符位置。表达式为空时清空结果。
示例
展开「示例」并选择查询,只会替换表达式,再查询当前 JSON,不会重新载入书店数据。收起「示例」不会改变表达式。
编辑预载的书店 JSON,或粘贴自己的 JSON 值。输入时实时查询,数字使用 JavaScript 精度;会被改值的数字(如超过 2^53 的整数)列在状态行。焦点在本工具内时,Ctrl+L(Mac 为 ⌘+L)清空两项输入和结果。

输入 JSON 和 JSONPath 表达式后,这里显示匹配的值。

结果 结果显示匹配的值,不显示规范化路径。单条匹配直接显示该值,多条组成 JSON 数组。无匹配和输入错误有不同提示;长结果在栏内滚动。 「复制」包含完整显示的 JSON,单个字符串保留引号,缩进为两个空格。出错或无匹配时不可复制;复制失败后可再次点击重试。
阅读完整使用指南 JSONPath 在线测试工具:不写代码也能查询 JSON 数据
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

JSONPath 语法参考(RFC 9535)

  • $ — 文档根节点
  • .key、['key']、["key"] — 对象成员
  • [n]、[-1] — 数组元素;负索引从末尾倒数
  • [start:end:step] — 切片,例如[0:2]、[1:]、[::-1]
  • [0,2]、['title','price'] — 一个方括号里放多个选择器,结果按选择器顺序排列
  • [*]、.* — 全部数组元素或对象成员值
  • ..key、..[0]、..* — 任意深度的后代
  • [?@.price < 10] — 过滤器;也可写成 [?(@.price < 10)]
  • [?@.isbn]、[?!@.isbn] — 成员存在 / 不存在
  • [?@.a.b == 'x' && @.c > $.min] — 过滤器内的嵌套路径、&& || !、以 $ 开头的绝对路径
  • length()、count()、match()、search()、value() — RFC 9535 定义的 5 个函数

示例:中文键名的订单数据

键名可以直接用中文,点号写法 $.订单 与方括号写法 $['订单'] 都能用(RFC 9535 允许 ASCII 以外的字符出现在点号后的名称里)。下面是一份虚构的订单数据,第 3 条的金额被后端写成了字符串:

{"订单": [
  {"编号": "A1001", "商品": "机械键盘", "金额": 399, "状态": "已发货"},
  {"编号": "A1002", "商品": "USB-C 数据线", "金额": 29.9, "状态": "待付款"},
  {"编号": "A1003", "商品": "显示器支架", "金额": "159.00", "状态": "已发货"}
]}

$.订单[?@.状态 == '已发货'].编号 得到 ["A1001","A1003"]。

再用 $.订单[?@.金额 > 100].商品 找金额超过 100 的商品,结果只有 ["机械键盘"],显示器支架没有出现:它的金额是字符串 "159.00",RFC 9535 §2.3.5.2.2 规定只有两边同为数字或同为字符串时 < 、> 才可能为真,工具不会提示。看到这种「少了一条」的结果,先检查字段类型。

中文输入法打出的符号

在中文标点状态下输入表达式时,[ 可能变成 【,$ 可能变成 ¥。这两类字符混进表达式后,读法不同:

  • 开头写成 ¥.订单 时,状态行显示 语法错误或不支持的语法: 查询必须以 $ 开头(第 1 个字符) · 表达式含全角字符(¥),请改用半角(ASCII)输入。。
  • 紧跟在名称后面时不会报错。$.订单【0】.商品 会被读成名为「订单【0】」的成员,结果是 未找到匹配项,状态行提示 表达式含全角字符(【 】)。JSONPath 把它们读作成员名的一部分,不当作 . [ ] * 或 $;请改用半角(ASCII)输入。 改成半角的 $.订单[0].商品 即可。

对象成员的顺序

$.地区.* 这类通配查询按 JavaScript 保存对象成员的顺序返回:形如数组下标的名称(如 "110000")排在前面并按数值升序,其余名称按 JSON 里的顺序排在后面。以地区代码为键的数据会被重新排序:

{"地区": {"440000": "广东省", "110000": "北京市", "310000": "上海市"}}

结果是 ["北京市","上海市","广东省"],不是 JSON 里的顺序。RFC 9535 没有规定对象成员的顺序,其他实现可能给出不同的顺序;需要固定顺序时请把数据改成数组。

限制

  • 语法错误和 RFC 9535 之外的语法会显示「语法错误或不支持的语法」和字符位置。RFC 9535 之外的语法包括脚本表达式 [(...)]、=~、in / nin,以及其他库用 ~ 取成员名之类的扩展。
  • $.store.book.length 选取名为 length 的成员,数组没有这个成员,所以结果为空。要按长度筛选,请在过滤器中用 length(),例如 $[?length(@.book) > 3]。
  • 结果只列出匹配的值,不显示规范化路径(如 $['store']['book'][0])。
  • 同一对象里出现两个同名键时,JSON.parse 只保留后一个值,查询看不到前一个。
  • 名称按码点逐个比较,不做 Unicode 规范化(名称选择器见 RFC 9535 §2.3.1.2;过滤器里的字符串比较,工具也按同样方式处理)。
  • match() 与 search() 把 . 换成 [^\n\r] 后,按带 u 标志的 JavaScript 正则执行(RFC 9485 §5.3)。JavaScript 不接受的模式结果为 false;\d、先行断言等只有 JavaScript 支持的写法也会被接受。
  • 数字经 JSON.parse 转成 JavaScript 数字。超过 253 的整数、位数过多的小数、-0 以及超出双精度范围的数会在比较和显示前改变,状态行会列出这些数字,例如 9007199254740993 → 9007199254740992。按 RFC 8259 §6,只有 −(253)+1 到 253−1 之间的整数能在各实现间通用,雪花 ID 这类长整数请以字符串传递。
  • JSON 格式错误时显示的是浏览器 JavaScript 解析器的原始信息,措辞因浏览器而异。

与其他 JSONPath 方言的区别

kubectl 的 -o jsonpath 模板把表达式写在大括号里,开头的 $ 可以省略;粘贴到这里时只取大括号里的部分,并在前面补上 $。 Java 的 Jayway JsonPath 接受脚本表达式、=~ 和路径末尾的 .length(),本工具按 RFC 9535 解析,会报错并指出位置。 只想筛选数据时用本工具即可;要改写 JSON 的结构,请用 jq Playground。

FAQ

什么是 JSONPath?

JSONPath 是 JSON 的查询语言,类似于 XML 的 XPath。它使用路径表达式从 JSON 文档中选取节点,RFC 9535(2024 年)对它做了标准化。kubectl 的输出模板、AWS Step Functions 和不少 API 测试工具都使用它的变体。

JSONPath 表达式中的 $ 是什么意思?

$ 指 JSON 文档的根元素。所有有效的 JSONPath 表达式必须以 $ 开头。单独使用时,$ 选取整个文档;之后可以链式添加选择器,例如 $.store.book[0].title。[*] 选取数组的全部元素,所以 $.store.book[*].author 返回所有作者。

过滤表达式如何使用?

过滤器写作 [?表达式],@ 表示正在判断的元素。按 RFC 9535,括号可写可不写,$.store.book[?@.price < 10] 与 $.store.book[?(@.price < 10)] 等价。可用 ==、!=、<、<=、>、>= 比较,用 &&、||、! 组合条件,判断 @.author.name 这样的嵌套路径,用 $ 与文档其他位置比较,并可调用 length()、count()、match()、search()、value()。字符串与数字永远不相等:写成 "9.99" 的价格不会小于 10。

递归下降(..)是什么?

.. 运算符递归搜索当前节点的所有后代。例如,$..author 在整个 JSON 树中查找所有 author 字段,无论嵌套深度如何。

为什么显示「语法错误或不支持的语法」?

表达式有语法错误(如字符串或方括号没有闭合),或用了 RFC 9535 没有定义的语法,工具会停下并给出原因和字符位置,不会返回空结果。RFC 9535 之外的写法常见的有脚本表达式 [(@.length-1)](改用 [-1])、=~ 运算符(改用 match() 或 search())、in / nin。显示「未找到匹配项」则说明表达式合法,只是 JSON 里没有符合的内容;如果表达式里有 . 或 【 这类全角字符或中文标点,状态行会提示,因为 JSONPath 把它们当作名称的一部分。

JSON 会被发送或保存吗?

不会。查询由本页的脚本执行,JSON 和表达式不会发送到服务器,也不会写入浏览器存储。统计只记录工具名和动作:有匹配结果的查询提交、点击示例、复制,不记录 JSON 和表达式。