JSONPath
在 Proxyman 中使用 JSONPath 查询 JSON 请求和响应正文。了解语法、过滤运算符，以及可直接复制的路径示例。
1. 这是什么？
JSONPath 是一种可以快速过滤 JSON 数据的查询语言。在 Proxyman 中，你可以在 JSON 标签页、Treeview 标签页以及自定义列中使用它。
2. 使用方法
- 在 Request 或 Response 面板中，点击 + 按钮
- 选择 JSON，添加 JSON 标签页
- 过滤栏会显示在 JSON 正文上方
- 选择 JSON Path 或 jq 过滤模式
3. 语法
| 运算符 | 说明 |
|---|---|
$ | 要查询的根元素。所有路径表达式都以它开头。 |
@ | 过滤谓词当前正在处理的节点。 |
* | 通配符。可用于任何需要名称或数字的位置。 |
.. | 深度扫描。可用于任何需要名称的位置。 |
.<name> | 点号表示法的子元素 |
['<name>' (, '<name>')] | 方括号表示法的一个或多个子元素 |
[<number> (, <number>)] | 数组索引 |
[start:end] | 数组切片运算符 |
[?(<expression>)] | 过滤表达式。表达式的结果必须为布尔值。 |
过滤运算符
过滤器是用于过滤数组的逻辑表达式。典型的过滤器为 [?(@.age > 18)]，其中 @ 表示当前正在处理的元素。
| 运算符 | 说明 |
|---|---|
| == | 左侧等于右侧（注意 1 与 '1' 不相等） |
| != | 左侧不等于右侧 |
| < | 左侧小于右侧 |
| <= | 左侧小于或等于右侧 |
| > | 左侧大于右侧 |
| >= | 左侧大于或等于右侧 |
| =~ | 左侧匹配正则表达式 [?(@.name =~ /foo.*?/i)] |
| in | 左侧存在于右侧中 [?(@.size in ['S', 'M'])] |
| nin | 左侧不存在于右侧中 |
| subsetof | 左侧是右侧的子集 [?(@.sizes subsetof ['S', 'M', 'L'])] |
| anyof | 左侧与右侧有交集 [?(@.sizes anyof ['M', 'L'])] |
| noneof | 左侧与右侧没有交集 [?(@.sizes noneof ['M', 'L'])] |
| size | 左侧（数组或字符串）的长度应与右侧相等 |
| empty | 左侧（数组或字符串）应为空 |
路径示例
以下面的 JSON 数据为例。
{
"store": {
"book": [
{
"category": "reference",
"author": "Nigel Rees",
"title": "Sayings of the Century",
"price": 8.95
},
{
"category": "fiction",
"author": "Evelyn Waugh",
"title": "Sword of Honour",
"price": 12.99
},
{
"category": "fiction",
"author": "Herman Melville",
"title": "Moby Dick",
"isbn": "0-553-21311-3",
"price": 8.99
},
{
"category": "fiction",
"author": "J. R. R. Tolkien",
"title": "The Lord of the Rings",
"isbn": "0-395-19395-8",
"price": 22.99
}
],
"bicycle": {
"color": "red",
"price": 19.95
}
},
"expensive": 10
}
| JsonPath | 结果 |
|---|---|
| $.store.book[*].author | 所有图书的作者 |
| $..author | 所有作者 |
| $.store.* | 所有内容，包括图书和自行车 |
| $.store..price | 所有商品的价格 |
| $..book[2] | 第三本书 |
| $..book[-2] | 倒数第二本书 |
| $..book[0,1] | 前两本书 |
| $..book[:2] | 从索引 0（含）到索引 2（不含）的所有图书 |
| $..book[1:2] | 从索引 1（含）到索引 2（不含）的所有图书 |
| $..book[-2:] | 最后两本书 |
| $..book[2:] | 从索引 2（含）到末尾的所有图书 |
| $..book[?(@.isbn)] | 所有带有 ISBN 编号的图书 |
| $.store.book[?(@.price < 10)] | 店内所有价格低于 10 的图书 |
| $..book[?(@.price <= $['expensive'])] | 店内所有不算“昂贵”（价格不高于 expensive 的值）的图书 |
| $..book[?(@.author =~ /.*REES/i)] | 所有匹配正则表达式的图书（忽略大小写） |
| $..* | 获取所有内容 |
| $..book.length() | 图书的数量 |