オプショナルプロパティ（prop?: string）はどのように処理されますか？

TypeScriptではオプショナルプロパティは省略可能なフィールドを表します。JSON Schemaでは明示的に 'required' 配列に含まれない限り省略可能です。strictNullChecks が有効な場合、'prop?: string' は 'required' から除外され、'prop: string | null' は 'required' に含まれた上で type が ['string', 'null'] となります。

どのJSDocタグがJSON Schemaのバリデーションキーワードに変換されますか？

通常のJSDocテキストは 'description' キーワードに変換されます。加えて、@minimum、@maximum、@minLength、@maxLength、@pattern、@format（email, uri, date-time, uuid 等）、@default、@deprecated などのタグが標準の検証制約として抽出されます。

Draft-07 と Draft 2020-12 の出力における主な違いは何ですか？

Draft-07は再利用スキーマに 'definitions' を使用し、タプル検証に配列形式の 'items' を使用します。Draft 2020-12では '$defs' を採用し、タプルには 'prefixItems' が使われ、OpenAPI 3.1 や最新のJSON Schemaエコシステムとの完全な互換性を持ちます。

1つのTypeScriptファイル内にある複数のinterfaceを同時に変換できますか？

はい、ルートとなるメインのinterfaceを指定することで、参照されているすべてのサブ型や依存interfaceが '$defs' または 'definitions' 内に体系的に抽出され、相対 $ref で自動リンクされます。

TypeScriptスキーマコンパイラ

TypeScript 型定義から JSON Schema 生成ツール (Draft-07 & 2020-12)

TypeScriptのinterface、typeエイリアス、JSDocコメントを、APIコントラクトやフォームビルダー向けの標準JSON Schema定義へ自動変換します。

Draft-07 & 2020-12 準拠

サーバー送信ゼロ

プリセット:

ドラフト規格:

ルート型:

定義キー名:

追加プロパティ許容:

フォーマット自動推論JSDocタグ解析

インデント:

TypeScript 型定義コード0 型定義数

/**
 * Core User Profile entity for enterprise authentication and RBAC
 * @title UserProfile
 * @description Primary identity record representing an authenticated user account
 */
UserProfile {
  /**
   * Primary system UUID v4 identifier
   * @format uuid
   */
  id: string;

/**
   * Validated primary email address
   * @format email
   */
  email: string;

/**
   * Unique handle or display username
   * @minLength 3
   * @maxLength 30
   * @pattern ^[a-zA-Z0-9_-]+$
   */
  username: string;

/**
   * Age in completed calendar years
   * @minimum 18
   * @maximum 120
   */
  age?: number;

/**
   * Account activation status
   * @default true
   */
  isActive: boolean;

/**
   * Access control security role
   */
  role: 'admin' | 'editor' | 'subscriber' | 'guest';

/**
   * Primary mailing and billing address
   */
  address: Address;

/**
   * Granted OAuth 2.0 permission scopes
   */
  permissions: string[];

/**
   * Account creation ISO-8601 timestamp
   * @format date-time
   */
  createdAt: string;

/**
   * Arbitrary key-value metadata tags
   */
  metadata?: Record<string, string>;
}

/**
 * Standardized postal and geolocation address definition
 * @title Address
 */
Address {
  street: string;
  suite?: string;
  city: string;
  state: string;
  /**
   * Postal or ZIP code
   * @pattern ^[0-9]{5}(?:-[0-9]{4})?$
   */
  postalCode: string;
  country: string;
  isPrimary?: boolean;
}

84 行数•1435 文字数•1.4 KB (バイト数)

TypeScript AST Ready

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EmptySchema",
  "type": "object",
  "properties": {}
}

2020-12 ($defs)•0 参照定義数•0 プロパティ数

0.1 KB 有効

検出された型定義

0AST解析完了

スキーマ規格

Draft 2020-12$defs

検証ルール & 制約

0件のルールを合成

100% クライアントサイドAST解析

ブラウザ内ローカル環境で構文木解析とスキーマ変換を高速実行。外部サーバーへの通信やデータ漏洩の心配は一切ありません。

Draft-07 & 2020-12 完全準拠

$defs/definitionsの自動リンク、タプルのprefixItems、enum展開、厳格な型判定など業界標準のJSON Schema仕様に完全準拠。

JSDocとスマート制約推論

コード内の@description、@minimum、@maximum、@format、@pattern、@defaultを自動抽出し、OpenAPI級の高品質なスキーマを出力。

TypeScript 型定義から JSON Schema 生成ツール (Draft-07 & 2020-12)

100% クライアントサイドAST解析

Draft-07 & 2020-12 完全準拠

JSDocとスマート制約推論

TypeScript インターフェース to JSON Schema (Draft-07 & 2020-12) — リファレンスガイド

主要パラメータ＆設定項目

プロの活用テクニック＆推奨設定

JSDocアノテーションによる制約の自動付与

Draft-07 と Draft 2020-12 における定義キーワードの違い

一般的なTypeScriptのUnion型

よくあるトラブルと解決策

再帰的・循環型の参照によるスタックオーバーフロー

高度なユーティリティ型（Omit, Pick, Partial）の解析エラー

よくある質問 (FAQ)

関連するおすすめ開発ツール