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つ出てくる。

  1. JavaScript の < は '5' < 10 を数値に変換して true にするが、RFC では型が違うので false
  2. キーが無い要素に @.price != 5 を当てると、RFC では「空は 5 と等しくない」ので true、つまりその要素は結果に入る

2つ目は直感に反するが、!= を == の否定として定義した以上こうなる。「price が 5 でない商品」を取ろうとして、price の無い要素まで拾ってしまう。

3つの実装で比べる

次のデータに同じ式を通した。b は price が文字列の "5"、c は price が無い。

1
2
3
4
5
6
7
8
9
10
{
"items": [
{ "name": "a", "price": 5 },
{ "name": "b", "price": "5" },
{ "name": "c" },
{ "name": "d", "price": 12 }
],
"nums": [1, 5, 10],
"a,b": 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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// jp-compare.mjs(Node.js v24.11.1 + jsonpath-rfc9535 1.3.0 + jsonpath-plus 11.3.0 で確認)
// 使い方: npm install jsonpath-rfc9535@1.3.0 jsonpath-plus@11.3.0 && node jp-compare.mjs
// 同じ式を RFC 9535 準拠の実装と Goessner 系の実装に通し、結果の違いを並べる
import { query, paths } from 'jsonpath-rfc9535';
import { JSONPath } from 'jsonpath-plus';

const doc = {
items: [
{ name: 'a', price: 5 },
{ name: 'b', price: '5' }, // 文字列の "5"
{ name: 'c' }, // price が無い
{ name: 'd', price: 12 },
],
nums: [1, 5, 10],
'a,b': 1,
"it's": 2,
};

const run = (f) => { try { return JSON.stringify(f()); } catch (e) { return 'ERROR'; } };
for (const p of [
'$.items[?(@.price < 10)].name',
'$.items[?@.price < 10].name',
'$.items[?(@.price == 5)].name',
'$.items[?(@.price != 5)].name',
'$.items[?(@.price < 1e2)].name',
'$.nums[?@ > 1]',
'$.nums[::-1]',
"$['a,b']",
]) {
console.log(p.padEnd(32), 'rfc9535=' + run(() => query(doc, p)).padEnd(16), 'plus=' + run(() => JSONPath({ path: p, json: doc, eval: 'safe' })));
}
console.log('normalized paths:', paths(doc, "$['it\\'s']"));
1
2
3
4
5
6
7
8
9
10
$ node jp-compare.mjs
$.items[?(@.price < 10)].name rfc9535=["a"] plus=["a","b"]
$.items[?@.price < 10].name rfc9535=["a"] plus=[]
$.items[?(@.price == 5)].name rfc9535=["a"] plus=["a","b"]
$.items[?(@.price != 5)].name rfc9535=["b","c","d"] plus=["c","d"]
$.items[?(@.price < 1e2)].name rfc9535=["a","d"] plus=["a","b","d"]
$.nums[?@ > 1] rfc9535=[5,10] plus=[]
$.nums[::-1] rfc9535=[10,5,1] plus=[10,5,1]
$['a,b'] rfc9535=[1] plus=[1]
normalized paths: [ "$['it\\'s']" ]

最後の行は console.log が文字列を表示するときのエスケープなので、実際の値は $['it\'s'] である。

次に、自前でフィルタを書くときのために、RFC 9535 の比較規則だけを取り出した最小実装である。外部パッケージは使わない。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
// rfc-compare.mjs(Node.js v24.11.1 で確認・外部パッケージ不要)
// 使い方: node rfc-compare.mjs
// RFC 9535 2.3.5.2.2 の比較規則を、JS の演算子をそのまま使わずに書いた最小実装
const NOTHING = Symbol('Nothing'); // キーが無いとき(空のノードリスト)

function eq(a, b) {
if (a === NOTHING || b === NOTHING) return a === b; // 両方 Nothing のときだけ true
if (typeof a !== typeof b) return false; // 13 == '13' は false
if (Array.isArray(a) || Array.isArray(b)) {
return Array.isArray(a) && Array.isArray(b) && a.length === b.length && a.every((x, i) => eq(x, b[i]));
}
if (a && b && typeof a === 'object') {
const ka = Object.keys(a), kb = Object.keys(b);
return ka.length === kb.length && ka.every((k) => k in b && eq(a[k], b[k]));
}
return a === b; // null も含めた同じ型の値
}
function lt(a, b) {
if (a === NOTHING || b === NOTHING) return false;
if (typeof a === 'number' && typeof b === 'number') return a < b;
if (typeof a === 'string' && typeof b === 'string') return a < b; // 注: JS は UTF-16 単位で比べる
return false; // '5' < 10 は false
}
export function compare(a, op, b) {
switch (op) {
case '==': return eq(a, b);
case '!=': return !eq(a, b);
case '<': return lt(a, b);
case '<=': return lt(a, b) || eq(a, b);
case '>': return lt(b, a);
case '>=': return lt(b, a) || eq(a, b);
}
throw new Error('unknown operator ' + op);
}

// @.key を読む。キーが無ければ Nothing
const get = (node, key) => (node && typeof node === 'object' && !Array.isArray(node) && Object.hasOwn(node, key)) ? node[key] : NOTHING;

const items = [{ name: 'a', price: 5 }, { name: 'b', price: '5' }, { name: 'c' }, { name: 'd', price: 12 }];
for (const [op, v] of [['<', 10], ['==', 5], ['!=', 5]]) {
const hit = items.filter((it) => compare(get(it, 'price'), op, v)).map((it) => it.name);
console.log(`@.price ${op} ${v}`.padEnd(14), JSON.stringify(hit));
}
// RFC 9535 2.3.5.3 の表の一部
console.log('absent1 == absent2', compare(NOTHING, '==', NOTHING));
console.log('absent1 <= absent2', compare(NOTHING, '<=', NOTHING));
console.log("absent != 'g' ", compare(NOTHING, '!=', 'g'));
console.log("13 == '13' ", compare(13, '==', '13'));
console.log('{x:"y"} != [2,3] ', compare({ x: 'y' }, '!=', [2, 3]));
1
2
3
4
5
6
7
8
9
$ node rfc-compare.mjs
@.price < 10 ["a"]
@.price == 5 ["a"]
@.price != 5 ["b","c","d"]
absent1 == absent2 true
absent1 <= absent2 true
absent != 'g' true
13 == '13' false
{x:"y"} != [2,3] true

結果は 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 取得)

JSONPathのフィルタは実装で結果が違う RFC 9535の比較規則
https://blog.hashito.biz/2026/11/17/jsonpath-filter-rfc9535-comparison-string-number-absent-key-jsonpath-plus/
著者
hashito
作成日
2026年11月17日
著作権

このバージョンはその範囲に入るのか

依存の話でいちばん間違えやすいのは ^1.2.3 や ~1.2.3 がどこまでを許すかです(^0.2.3 のようにメジャーが 0 のときは規則が変わります)。範囲とバージョンを貼ると、下限・上限に展開したうえで一致・不一致とその理由を表示するsemver 範囲判定ツールを置いています。ブラウザの中だけで動き、入力はどこにも送信しません。