JSON vers TypeScript
Génère des interfaces TypeScript à partir d’un échantillon JSON.
Votre JSON est analysé et converti entièrement dans votre navigateur, il reste donc sur votre appareil et rien n'est envoyé à un serveur.
Besoin de types Go, Rust ou Python ? Essayez JSON vers Code.
À propos de JSON vers TypeScript
Ce convertisseur json vers typescript transforme un objet ou tableau JSON d'exemple en interfaces TypeScript prêtes à l'emploi en quelques secondes. Collez une vraie réponse d'API et il infère les types de champs, imbrique les objets enfants dans leurs propres interfaces nommées, fusionne les tableaux d'objets en une seule forme et marque comme optionnelles, avec un point d'interrogation, les clés absentes de certains éléments. Il est conçu pour les développeurs frontend et backend, les ingénieurs QA et toute personne qui câble des clients typés et préfère générer des types typescript depuis json plutôt que de les écrire à la main. Utilisez-le comme générateur d'interface typescript rapide pour explorer un endpoint inconnu, ou pour garder vos modèles synchronisés avec des charges utiles d'exemple. Tout s'exécute localement dans votre navigateur, le JSON que vous collez est traité sur votre appareil et rien n'est envoyé à un serveur.
Fonctionnalités
- Génère des interfaces TypeScript nommées depuis tout objet ou tableau JSON
- Transforme les objets imbriqués en leurs propres interfaces exportées avec des noms en PascalCase
- Fusionne les tableaux d'objets en une seule interface couvrant chaque clé
- Marque comme optionnelles, avec un point d'interrogation, les clés absentes de certains éléments
- Infère les types primitifs, tableau, union et null depuis vos valeurs d'exemple
- Vous laisse renommer l'interface racine pour correspondre à votre modèle
- Valide le JSON et localise la ligne et la colonne des erreurs de syntaxe
- Copiez le résultat ou téléchargez-le sous forme de fichier .ts
Comment utiliser JSON vers TypeScript
- Collez votre objet ou tableau JSON dans la zone de saisie.
- Définissez le nom de l'interface racine pour correspondre à votre modèle, ou laissez Root.
- Examinez les interfaces TypeScript générées dans le panneau de sortie.
- Copiez le résultat ou téléchargez-le sous forme de fichier .ts.
Exemple
Entrée
{ "id": 1, "name": "Ada", "tags": ["a", "b"] }
Sortie
export interface Root {
id: number;
name: string;
tags: string[];
}
Un objet JSON plat devient une seule interface typée.
Erreurs courantes et dépannage
- La sortie affiche une erreur Invalid avec une ligne et une colonne. — Le JSON a un problème de syntaxe tel qu'une virgule en trop, des apostrophes simples ou une clé sans guillemets. Corrigez-le à la ligne et la colonne signalées, puis les interfaces se régénèrent.
- Un champ que vous attendiez est marqué optionnel avec un point d'interrogation. — Cette clé est absente d'au moins un élément de votre tableau d'exemple. Incluez-la dans chaque élément si elle doit toujours être requise.
- Une propriété ressort avec le type unknown. — Toutes les valeurs d'exemple de cette clé étaient null ou undefined, donc aucun type concret n'a pu être inféré. Fournissez un exemple avec une vraie valeur pour ce champ.
- Coller une valeur seule comme un nombre ou une chaîne ne produit qu'un alias de type. — C'est normal. Enveloppez la valeur dans un objet ou un tableau si vous voulez une interface nommée plutôt qu'un simple alias de type exporté.
Foire aux questions
- Qu'est-ce que le convertisseur JSON vers TypeScript ?
- C'est un outil qui lit un objet ou tableau JSON d'exemple et génère les interfaces TypeScript correspondantes, en inférant le type de chaque champ pour que vous puissiez intégrer le résultat directement dans votre base de code.
- Comment convertir du JSON en interfaces TypeScript ?
- Collez votre JSON dans la zone de saisie, définissez éventuellement le nom de l'interface racine, puis copiez ou téléchargez les interfaces générées depuis le panneau de sortie.
- Comment JSON vers TypeScript gère-t-il les tableaux d'objets ?
- Il fusionne les clés de chaque élément en une seule interface. Toute clé absente de certains éléments est marquée optionnelle avec un point d'interrogation pour que le type couvre tout le tableau.
- Comment les objets imbriqués sont-ils convertis en TypeScript ?
- Chaque objet imbriqué devient sa propre interface exportée avec un nom en PascalCase, et le parent le référence par son type plutôt que d'incorporer la forme.
- Que se passe-t-il avec les valeurs null ou de types mixtes ?
- Les valeurs null produisent une union avec null, et les champs qui contiennent plus d'un type primitif deviennent une union telle que string | number.
- Mon JSON est-il envoyé quelque part lorsque je le convertis en TypeScript ?
- Non. La conversion JSON vers TypeScript s'exécute entièrement dans votre navigateur, les données que vous collez sont traitées localement et ne quittent jamais votre appareil.
Outils associés
Tous les outils ArrayKit