jsonecho

XML to TypeScript

Paste an XML document and get TypeScript types that match its structure.

Loading the tool...

How to use XML to TypeScript

  1. Paste a representative XML 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 XML to TypeScript

Writing model classes by hand for a big XML 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.

XML is first converted to JSON the same way as in our XML to JSON tool: attributes get an @_ prefix and text content next to attributes is called #text. The TypeScript types are generated from that result. An interface only exists at compile time. If you need to check incoming data at runtime, keep the Convert class.

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 XML with the result?

Convert the XML to JSON first (our XML to JSON tool does this the same way), then 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 XML 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 →