本文へスキップ
型補助

JSON → TypeScript 型生成

JSON のサンプルから、TypeScript の型(「type Root = { ... };」)を作ります。API レスポンスや設定ファイルを貼るだけで、型付けの出発点ができます。配列の要素の形が違うときは1つの型にまとめ、一部の要素にしかないキーは 「email?: string」 のような省略可能なキーにします。空の配列は 「unknown[]」、「null」 を含む値は 「string | null」 のような合併型になります。数値は整数も小数も 「number」、日時の文字列は 「string」 で、ネストしたオブジェクトには別名を付けず、入れ子のまま出力します。サンプル1つからの推論なので、必須かどうか・列挙・共通の型への切り出しは、仕様に合わせて手直ししてください。処理はすべてブラウザの中で行われ、JSON は送信されません。

他の言語: Go・Python・Rust・Kotlin・C#

上の JSON を、別の言語の型にします。Go の構造体(json タグつき)・Python の TypedDict(3.11 以上)・Rust の serde 構造体・Kotlin の data class(kotlinx.serialization)・C# のクラス(System.Text.Json)に対応。入れ子のオブジェクトは名前つきの型になり、無いキーは省略可能になります。データは送信されません。

ガイド

使い方・特徴

  • 上の入力欄に JSON を貼り付けて「TypeScript に変換」をクリックします。
  • オブジェクトはプロパティごとの型が付いたブロックとして整形されます。
  • 配列は要素型を判定し、複数の型が混ざる場合はユニオンで表現します。
  • コピー・リセットボタンで結果を再利用したりやり直したりできます。
サンプル

入力例と出力例

Generate TypeScript types

入力例
{"title":"Draft","tags":["dev","web"],"stats":{"views":1200}}
出力例
type Root = {
    title: string;
    tags: string[];
    stats: {
        views: number;
    };
};
FAQ

よくある質問

  • どんな型が出力されますか?

    `type Root = { ... };` の形の型エイリアスです。ネストしたオブジェクトは、別の名前を付けずに、入れ子のまま出力します。名前を変えたり、`interface` にしたいときは、手で書き換えてください。
  • 配列の要素の形が違うときは、どうなりますか?

    要素を1つの型にまとめます。一部の要素にしかないキーは、`email?: string` のような省略可能なキーになります。種類の違う値が混じるときだけ `string | number` のような合併型になります。
  • 空の配列や `null` は、どうなりますか?

    空の配列は、要素の型が分からないので `unknown[]` にします(`any[]` にはしません)。`null` を含む値は、`string | null` のような合併型になります。
  • 整数と小数、日付は区別されますか?

    されません。数値はすべて `number`、日時の文字列も `string` です。`Date` や `bigint` にはなりません。
  • `my-key` のような、識別子にできないキーは?

    `"my-key": string;` のように、引用符で囲んで出力します。
  • 入力した JSON は送信されますか?

    送信されません。変換は、すべてブラウザの中で行います。
使いどころ

主な活用シーン

  • API レスポンスの型を、すばやく作る

    実際のレスポンスを貼って、`fetch` の結果に付ける型の出発点を作れます。
  • 設定ファイルや JSON データの型付け

    `config.json` や、アプリが読み込む JSON の形を、型として書き起こせます。
  • モックデータの型をそろえる

    テスト用の JSON から型を作って、モックと本物のデータの形を、そろえやすくなります。
  • 型定義の叩き台を作る

    ゼロから書く代わりに、サンプルから骨組みを作り、名前や、共通の型への切り出しだけを手で直せます。
注意点

注意事項・制限

  • サンプル1つからの推論です

    JSON に現れた値だけを見て型を作ります。「この値は、実は列挙型」「このキーは必須」といった、仕様の情報は含まれません。必ず内容を確認してください。
  • ネストしたオブジェクトに名前は付きません

    入れ子のまま出力するので、同じ形が何度も出てきても、共通の型にはまとまりません。必要に応じて、`type User = ...` のように切り出してください。
  • 辞書のような JSON は、`Record` にはなりません

    キーが ID のように変わるオブジェクトも、見えているキーだけの型になります。`Record<string, T>` が適切なときは、手で書き換えてください。
  • 大きな整数は、丸められます

    JavaScript の数値で正確に表せない大きな整数は、JSON を読み込む時点で丸められます。ID などは、文字列で受け取る設計を検討してください。
概要

このツールについて

JSONからTypeScript型推論・Interface生成

APIのレスポンスやダミーデータのJSONオブジェクトを解析し、TypeScriptの interface や type 定義(型定義)をワンクリックで自動生成するツールです。
フロントエンド開発(Next.js / React, Vueなど)で、厳格な型チェックを行うための型定義ファイルを作成する工数を大幅に削減します。入れ子構造(ネストされたオブジェクトや配列)のパースにも対応し、開発サイクルをシームレスにつなぎます。

フロントエンド開発での使いどころ

APIレスポンスの型を早い段階で用意しておくと、画面実装中にプロパティ名の打ち間違いやnullの扱いに気づきやすくなります。サンプルレスポンスを貼り付けて型を生成し、APIクライアントやReactコンポーネントのpropsに利用することで、実装とデータ構造のずれを減らせます。
特に管理画面やダッシュボードのように、ネストした配列や複数の状態を持つJSONを扱う画面では、手書きの型定義に時間がかかります。生成した型をベースに、ドメイン上の意味が伝わる名前へ整えると、チーム内でも読みやすいコードになります。

生成結果を調整する観点

JSONの値だけから推論するため、空配列、null、ID文字列、日付文字列などはプロジェクトのルールに合わせた確認が必要です。たとえば日付は単なる string として出力されることが多いため、必要に応じて型エイリアスやコメントを追加すると保守しやすくなります。外部APIのサンプルを使う場合は、個人情報やトークンを含まない形に加工してから利用してください。

おすすめリソース

このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。

このツールの関連記事

このツールの実装解説

運営者のZenn記事 ↗

作る過程で踏んだバグや設計の判断を、Zennに書いています。

最新記事