JSONツール

ウェブ上のほぼすべてのJSONツールは、ドキュメントをサーバーに送信するフォームです。チュートリアルのコード片ならそれでも構いません。しかし、デバッグ対象の実際のペイロードでは、まず問題になります。本番のJSONにはアクセストークン、顧客レコード、内部ホスト名、アカウント識別子が含まれていることが多く、それを知らないエンドポイントに貼り付けることは、これらすべてを他人のアクセスログに引き渡すのと同じです。規制のある環境では判断の余地などなく、報告義務のあるインシデントです。

このサイトのツールは、サーバーという概念自体を排除しています。読み込むページは静的なHTMLとJavaScriptであり、ドキュメントを貼り付けると、タブで実行中のコードがそのまま解析します。検査すべきリクエストも、信用すべきエンドポイントも存在しません。これは「覗きません」という約束よりはるかに強い立場です。

この判断は速度にも効いています。アップロードも待ち行列も往復もないため、2 MBのドキュメントの整形は、大西洋を2回往復する時間ではなく、画面を再描画する程度の時間で終わります。さらに、機内でも、厳しく制限された社内ネットワークでも、未知の通信をすべて遮断するVPNの中でも動作します。

エンジンはパッケージの組み合わせではなく手書きで実装されています。これは聞こえ以上に重要です。パーサーは再帰ではなく反復で書かれているため、深くネストしたドキュメントでもJavaScriptのコールスタックを破壊する代わりにエラーを報告します。テストスイートには2万段階のネストを流し込むテストが含まれています。ドキュメントから来るすべてのキーはown propertyのガードを通して代入されるため、__proto__を含むペイロードが検査側ページの動作を変えることはできません。これは理論上の心配ではなく、JSONツールが実際に壊れる2つの経路です。

標準が存在する場所では、それに正確に従います。文法はRFC 8259、パッチドキュメントはRFC 6902、マージパッチはRFC 7386、推論と検証はJSON Schema Draft 2020-12です。標準が裁量を残している部分、たとえば比較時の配列要素の照合方法や、出力時のキーのソート有無は、ハードコードせず設定として公開し、各ページのリファレンステーブルにその挙動の細部まで記載しています。

どこから始めるべきかわからない場合の目安です。パースできないドキュメントにはJSON検証、一致するはずなのに一致しない2つのドキュメントにはJSON差分比較、読めないドキュメントにはJSON整形、そして自分で書いていないレスポンスの構造を記述する必要があるときにはJSONスキーマ生成を使います。