真偽値バリデーション — JSON Schemaでboolean型を扱う
JSON Schemaでboolean型のバリデーションを定義し、true/false値を正しく制約する方法を紹介します。
Basic Types
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"isActive": {
"type": "boolean"
},
"emailNotifications": {
"type": "boolean",
"default": true
},
"acceptedTerms": {
"type": "boolean",
"const": true
}
},
"required": ["isActive", "acceptedTerms"]
}Test Data
{
"isActive": true,
"emailNotifications": false,
"acceptedTerms": true
}詳細な説明
JSON Schemaの boolean 型は、true または false のみを受け入れるシンプルな型です。文字列の "true" や数値の 1 は有効なboolean値とみなされません。
ポイント:
type: "boolean"を指定するだけで、値が厳密にtrueまたはfalseであることを検証できます。constキーワードと組み合わせて、特定の値（例:const: true）のみを許可することも可能です。defaultキーワードでデフォルト値を指定できますが、これはバリデーション自体には影響しません。
boolean型は設定フラグ、トグルスイッチ、同意チェックボックスなどの値を表現する際に頻繁に使用されます。
ユースケース
ユーザーの同意フラグ、機能のオン・オフ切り替え、フィルタ条件などのboolean値をバリデーションする際に使用します。