JSONPathのフィルタは実装で結果が違う RFC 9535の比較規則
JSONPath は長いあいだ、2007年の Stefan Goessner の記事が事実上の仕様だった。各言語の実装はそれぞれの解釈で作られ、2024年2月にようやく IETF の標準 RFC 9535「JSONPath: Query Expressions for JSON」が出た。
困るのは、同じ式でも実装によって返る結果が違うことである。特にフィルタ式 ?(@.price < 10) は、値が文字列の "5" だったとき、キーそのものが無いとき、で答えが分かれる。
この記事では、ハシトシステムの JSONPath 評価ツール と、RFC 9535 準拠をうたう jsonpath-rfc9535、Goessner 系の代表的な実装 jsonpath-plus に同じ式を通して、どこで結果が分かれるかを確かめる。検証環境は Windows 11、Node.js v24.11.1、jsonpath-rfc9535 1.3.0、jsonpath-plus 11.3.0 である。
RFC 9535 の比較規則
フィルタ式の比較は、RFC 9535 の 2.3.5.2.2 で決められている。まず == と < を定義し、残りの演算子はそれを組み合わせて作る。
| 状況 | == |
< |
|---|---|---|
| 片方が空のノードリスト(キーが無い) | もう片方も空なら true、そうでなければ false | false |
| 数値どうし | 数学的に等しいか | 数学的な大小 |
| 文字列どうし | 等しいか | Unicode のスカラー値で辞書順 |
| 型が違う(数値と文字列など) | false | false |
| 配列・オブジェクトどうし | 中身が再帰的に等しいか | false |
そのうえで、a != b は a == b の否定、a <= b は a < b か a == b、a > b は b < a と定義される。RFC の例の表には次の行がある。
$.absent1 == $.absent2は true(どちらも空)$.absent != 'g'は true(片方が空)13 == '13'は false(型が違う)
ここから、JavaScript の演算子をそのまま使うと合わない点が2つ出てくる。
- JavaScript の
<は'5' < 10を数値に変換して true にするが、RFC では型が違うので false - キーが無い要素に
@.price != 5を当てると、RFC では「空は 5 と等しくない」ので true、つまりその要素は結果に入る
2つ目は直感に反するが、!= を == の否定として定義した以上こうなる。「price が 5 でない商品」を取ろうとして、price の無い要素まで拾ってしまう。
3つの実装で比べる
次のデータに同じ式を通した。b は price が文字列の "5"、c は price が無い。
1 | |
ハシトシステムのツールは、2026-11-17 に本番の HTML から評価関数を取り出して Node.js で動かした。jsonpath-plus は eval: 'safe' で実行した。
| 式 | ツール | jsonpath-rfc9535 | jsonpath-plus |
|---|---|---|---|
$.items[?(@.price < 10)].name |
["a","b"] |
["a"] |
["a","b"] |
$.items[?(@.price == 5)].name |
["a"] |
["a"] |
["a","b"] |
$.items[?(@.price != 5)].name |
["b","d"] |
["b","c","d"] |
["c","d"] |
$.items[?@.price < 10].name |
式のエラー | ["a"] |
[] |
$.items[?(@.price < 1e2)].name |
式のエラー | ["a","d"] |
["a","b","d"] |
$.nums[?@ > 1] |
式のエラー | [5,10] |
[] |
$.nums[::-1] |
式のエラー | [10,5,1] |
[10,5,1] |
$['a,b'] |
式のエラー | [1] |
[1] |
!= の行は3つとも答えが違う。
- jsonpath-rfc9535 は規則どおり、文字列の
"5"(型が違うので等しくない)と、price の無いc(空なので等しくない)の両方を返す - jsonpath-plus は JavaScript の緩い比較に近い動きで、
"5"を 5 と等しいとみなして外し、price の無いcは返す。==の行でも"5"を拾っている - ツールは「キーがあって、かつ比較が真」のものだけを返すので、
cを外す。==と!=は厳密な比較(===)なので"5"は 5 と等しくない
< の行では、ツールと jsonpath-plus がどちらも "5" < 10 を true にしている。RFC では false である。
括弧の無い ?@.price < 10 は RFC 9535 の書き方で、文法は filter-selector = "?" S logical-expr である。括弧付きの ?(...) は「括弧で囲んだ論理式」として同じ文法に含まれるので、RFC 準拠の実装はどちらも受け付ける。jsonpath-plus は括弧の無い形をエラーにせず、空の結果を返した。エラーにならずに空が返るのは、気付きにくいので要注意である。
ほかに、RFC 9535 では次のものも正しい式である。
- 数値の指数表記
1e2(文法number = (int / "-0") [ frac ] [ exp ]) - スライスの step
[::-1](逆順になる。step が 0 なら空) @だけのフィルタ?@ > 1(配列の要素そのものと比べる)- 名前にカンマや
]を含む$['a,b']
ツールの判定と修正点
ハシトシステムの JSONPath 評価ツールは、記法の出典を Goessner の JSONPath としており、ページに「対応している記法」と「対応していない記法」の表がある。スライスの刻み幅や、フィルタ内の && || は非対応と明記され、入力すると理由付きのエラーを出す。黙って空を返すより書けないと分かるほうが直しやすい、という方針で、表の「式のエラー」のうち [::-1] はこれに当たる。
そのうえで、RFC 9535 から見て直したほうがよいのは次の点で、修正対象として記録した。
<><=>=が JavaScript の比較そのままなので、"5" < 10が true になる。型が違うときは false にする!=でキーの無い要素を外している。RFC に合わせるなら含める。ただし利用者の直感とは逆になるので、画面に「キーが無い要素も一致します」と添えるのがよい[から最初の]までを切り出し、カンマで分けているため、$['a,b']や$['a]b']がエラーになる。ページには「記号や空白を含むキーは['...']を使う」とあるので、説明とも食い違っている- 括弧の無いフィルタ
?@.price < 10、@だけのフィルタ?@ > 1、指数表記の1e2は、非対応の一覧に無いのにエラーになる。対応するか、一覧に加える - 結果のパスで名前の中の
'や改行をエスケープしていない。RFC 9535 2.7 の Normalized Path では'を\'、改行を\nと書く決まりで、ツールはit'sというキーを$['it's']と出してしまう
同じツールで JSON の値そのものの扱いを調べた記事として、JSON整形で値が変わる 大きな整数・1.0・1e400とrawJSON もある。
実際に試す
前提: Node.js(確認は v24.11.1)。1つ目は npm パッケージを2つ使う。
まず、RFC 9535 準拠の実装と Goessner 系の実装で同じ式を比べるスクリプトである。空のディレクトリで実行する。
1 | |
1 | |
最後の行は console.log が文字列を表示するときのエスケープなので、実際の値は $['it\'s'] である。
次に、自前でフィルタを書くときのために、RFC 9535 の比較規則だけを取り出した最小実装である。外部パッケージは使わない。
1 | |
1 | |
結果は jsonpath-rfc9535 と一致し、RFC の例の表とも合う。
文字列の大小は、この実装では JavaScript の < に任せている。JavaScript は UTF-16 のコード単位で比べるため、絵文字のようなサロゲートペアの文字と U+E000 以降の文字との大小が、RFC の「Unicode のスカラー値で比べる」とは逆になることがある。厳密に合わせるなら [...a] で1文字ずつに分けて codePointAt(0) を比べる。
使う側としての注意
- 同じ JSONPath 式を別の言語やライブラリに持っていくと、フィルタの結果が変わることがある。式だけでなく、どの仕様の実装かを確かめる
- 値の型が揃っていないデータ(数値と文字列が混ざる、キーがあったり無かったりする)にフィルタをかけるときは、実装の違いが出やすい。
!=は特に、キーの無い要素を含むかどうかが実装で分かれる - キーの無い要素を外したいなら、RFC 9535 では存在の確認を組み合わせて
?@.price && @.price != 5と書く - エラーにならずに空の結果が返る実装がある。期待した件数が返っているかをテストで確かめる
まとめ
- JSONPath は2024年2月の RFC 9535 で標準になったが、それ以前の Goessner 系の実装が今も広く使われている。
- フィルタの比較は RFC 9535 で型を厳密に区別し、
'5' < 10は false、キーの無い要素に!= 5は true になる。 - 同じ式でも jsonpath-rfc9535 1.3.0 と jsonpath-plus 11.3.0 では
<==!=の結果が違い、括弧の無いフィルタは jsonpath-plus では空になった。 - ハシトシステムの JSONPath 評価ツールは Goessner の記法を出典とする実装で、比較の型の扱いと名前の切り出しに RFC との違いがある。
結果は 2026-11-17 時点の上記の環境とツールの実装で得たものである。
参考
- RFC 9535「JSONPath: Query Expressions for JSON」(2024年2月)2.3.4 Array Slice Selector、2.3.5 Filter Selector、2.3.5.2.2 Comparisons、2.3.5.3 Examples、2.7 Normalized Paths
- jsonpath-rfc9535 1.3.0 の README(JSONPath Compliance Test Suite に全件合格と記載)と上記スクリプトでの実測
- jsonpath-plus 11.3.0 での実測
- ハシトシステム JSONPath 評価ツールの本番 HTML(2026-11-17 取得)
このバージョンはその範囲に入るのか
依存の話でいちばん間違えやすいのは ^1.2.3 や ~1.2.3 がどこまでを許すかです(^0.2.3 のようにメジャーが 0 のときは規則が変わります)。範囲とバージョンを貼ると、下限・上限に展開したうえで一致・不一致とその理由を表示するsemver 範囲判定ツールを置いています。ブラウザの中だけで動き、入力はどこにも送信しません。