JSON スキーマ バリデータ

JSON スキーマ バリデータの機能

• 01

  Ajv を活用

  Ajv は事実上の JavaScript JSON スキーマバリデータです。ここで渡されるものは Node.js、Fastify、Ajv ベースのリンター、その他のほぼすべての JS ツールチェーンで渡されます。

• 02

  一度にすべてのエラー

  allErrors: true で設定されているため、結果は最初のエラーで停止するのではなく、すべての失敗をリストします——形式が正しくない API ペイロードを修正するときに便利です。

• 03

  パスに対応したメッセージ

  各エラーには失敗値への JSON ポインタが含まれているため、大きなドキュメント内で失敗した フィールドに直接ジャンプできます。

JSON スキーマ バリデータのよくある質問

どの JSON スキーマドラフトがサポートされていますか？

Ajv はドラフト 6、7、2019-09、2020-12 をそのままサポートしています。デフォルトモードは非厳密なので、ほとんどの日常的なスキーマ（type、properties、required、items など）は追加設定なしで機能します。

$ref スキーマが読み込まれない理由は？

外部 $ref（他のスキーマへの URL）はこのブラウザのみのツールではフェッチされません。すべての $defs をインラインにして、#/$defs/Address のようなローカルポインターを使用します。

スキーマまたはデータはどこかにアップロードされますか？

いいえ。Ajv はブラウザで完全に実行されます——スキーマとデータはデバイスに留まります。

これで OpenAPI 仕様を検証できますか？

間接的に。OpenAPI のリクエスト/レスポンスボディは JSON スキーマフラグメントです——単一のボディスキーマとマッチングサンプルデータをここに貼り付けます。OpenAPI ドキュメント全体の検証には専用の OpenAPI バリデータが必要です。