What happens to arrays of objects?

They're merged into one interface describing a single element, and the property is typed as an array of it. Any key that appears in some array members but not others becomes optional. This matches how real paginated data behaves, where records come from one table and some columns are nullable. The one case it handles badly is a genuinely heterogeneous array of different event types, which you should hand-convert into a discriminated union.

Should null become an optional key or a union with null?

It depends on whether your API omits absent fields or sends them as null. If it omits them, key?: T is accurate. If the key is always present and sometimes null, key: T | null is accurate, and using ? would wrongly allow the key to be missing. The converter defaults to optional and lets you switch, because the two serialise differently — JSON.stringify drops undefined properties but emits null ones.

Can it infer accurate types from a single JSON sample?

It infers accurate types for that sample, which isn't the same thing. A field that's a number in your one record might be null in others; a field present in all three records you pasted might be optional across the full dataset. Use a representative payload with several records rather than one hand-picked object, and treat the output as a reviewed draft rather than a finished contract.

What's the difference between JSON to TypeScript and JSON Schema to TypeScript?

This tool infers types from an example value; JSON Schema to TypeScript translates a formal schema that already declares types, required fields, and enums. The schema is authoritative and inference is a guess, so if you have a JSON Schema, an OpenAPI spec, or a GraphQL schema, use it. Inference is for the very common case where no schema exists and all you have is a response body.

How does it handle keys that aren't valid identifiers?

Keys with dashes, dots, spaces, or leading digits are quoted in the output, so "content-type" becomes "content-type": string. That's valid TypeScript, accessed with bracket notation. Reserved words like class don't need quoting as property names. Interface names derived from such keys are PascalCased and prefixed if they'd start with a digit, and colliding names get a numeric suffix so the output always compiles.

Should I generate interfaces or type aliases?

Match whatever your codebase already does — this is mostly a consistency question. Interfaces support declaration merging and extends, and give marginally clearer error messages. Type aliases can't merge, which is usually desirable, and are required for anything that isn't an object shape. A root that's an array or a primitive is emitted as an alias either way, since there's no object to declare an interface for.

Is my JSON uploaded to a server?

No. The entire inference engine runs as JavaScript in your browser, with no network calls, no logging, and no storage. This matters here more than for most tools, because the JSON you'd paste into a type generator is usually a real API response containing tokens, customer records, or internal IDs. Open your network tab while generating, or disconnect from the internet — it keeps working.

JSON vers TypeScript : Générez des interfaces précises à partir de données d'API réelles

Toolz Team

|Jul 21, 2026|4 min read

Share
Now

Outils associés : Formateur JSON Pour inspecter la charge utile en premier, JSON vers Yaml et JSON vers XML pour la conversion de format, et Diff JSON Pour repérer ce qui a changé entre deux réponses. Lectures complémentaires : Le guide ultime des outils JSON et Guide des outils de codage du développeur.

Frequently Asked Questions

Paste your JSON into the converter, set the root type name to whatever the resource is called, and press Generate. It infers the type of every key, pulls nested objects out into their own named interfaces, merges arrays of objects into a single element type, and outputs code you can copy straight into a .ts file. There's no signup and no upload — the inference runs in your browser.

Articles similaires

general

Générateur de sitemap XML : Créez une confiance des moteurs de recherche SiteMap.xml

Transformez une liste d'URL en un sitemap.xml valide avec LastMod, ChangeFreq et Priority. Découvrez ce qui appartient à un sitemap, la limite de 50 000 URL et comment le soumettre

Toolz Team·Jul 26·17m

general

Calculatrice de pourboires : divisez la facture sans les mathématiques maladroites

Déterminez le pourboire et divisez la facture de restaurant en quelques secondes. Définissez un pourcentage, ajoutez la taxe de vente, choisissez avant taxe ou après impôt, et rassemblez - gratuit, privé et parcourez

Toolz Team·Jul 26·16m

general

Vérificateur de contraste de couleur : Comment frapper WCAG AA et AAA sans deviner

Vérifiez le contraste des couleurs pour WCAG AA et AAA en ligne, gratuitement. Ce que signifie le rapport, les seuils exacts et comment corriger une couleur défaillante sans abandonner votre marque.

Toolz Team·Jul 22·16m

Comments

0 comments

No comments yet. Be the first to share your thoughts!

Command Palette

JSON vers TypeScript : Générez des interfaces précises à partir de données d'API réelles

Frequently Asked Questions

Articles similaires

Générateur de sitemap XML : Créez une confiance des moteurs de recherche SiteMap.xml

Calculatrice de pourboires : divisez la facture sans les mathématiques maladroites

Vérificateur de contraste de couleur : Comment frapper WCAG AA et AAA sans deviner

Comments