jsonecho

JSON to TypeScript

Paste a JSON sample and get TypeScript types for it.

Loading the tool...

How to use JSON to TypeScript

  1. Paste a representative JSON sample, ideally one with all the optional fields filled in.
  2. Set the name of the root type, and decide whether you want helper code as well or types only.
  3. Copy the generated TypeScript code into your project.

About JSON to TypeScript

Writing model classes by hand for a big JSON payload is dull, and it is where typos creep in. Paste a sample here and the generator works out the structure: which fields exist, which are objects, which are arrays and what type each value has. The output is interfaces for every object. Untick "Types only" and a Convert class with runtime checks is added.

An interface only exists at compile time. If you need to check incoming data at runtime, keep the Convert class. Everything runs in your browser, so your sample data stays on your machine.

Using the generated code

Cast with const data: Root = JSON.parse(text), or use the generated Convert.toRoot(text) for validation.

Optional properties are written with a question mark, and nullable ones as string | null.

Frequently asked questions

What does the generated TypeScript code depend on?

The output is interfaces for every object. Untick "Types only" and a Convert class with runtime checks is added.

How do I parse JSON with the result?

Cast with const data: Root = JSON.parse(text), or use the generated Convert.toRoot(text) for validation.

How are optional and missing fields handled?

Optional properties are written with a question mark, and nullable ones as string | null.

Does the generator look at more than one record?

It only knows what is in your sample. If a field is missing from your example, it will not appear in the types, and if a value is null in your example, its type is unknown. Paste an example in which as many fields as possible are filled in, or paste an array with several different records.

Is my JSON sent to a server?

No. The generator is downloaded to your browser the first time you use it, about 1 MB, and everything runs locally.

More in Data to Class

All tools →