JSON vers TypeScript
Transformez un échantillon JSON ordinaire en un alias de type TypeScript lisible. Inspectez les champs facultatifs et les tableaux mixtes, puis copiez le code ou enregistrez un fichier TypeScript. Le résultat décrit la structure observée et les besoins d'examen ; il ne valide pas les données futures au moment de l'exécution.
Générer un type à partir de JSON
- Collez un document JSON ou chargez l’exemple. Les objets, tableaux et valeurs primitives à la racine sont acceptés dans les limites indiquées. Les commentaires, virgules finales, clés dupliquées après décodage et unités de substitution UTF-16 non appariées sont rejetés.
- Choisissez un nom de type racine commençant par une lettre majuscule ASCII, suivie de lettres, de chiffres ou de traits de soulignement, jusqu'à 64 caractères. Sélectionnez deux ou quatre espaces et Générez le type.
- Examinez les champs déduits et la qualification d’échantillon uniquement. Copier écrit uniquement le code actuel ; Télécharger TypeScript enregistre le même code UTF-8 que json-types.ts. La modification d'une entrée efface l'ancien résultat.
Comment fonctionne l'inférence d'échantillon
Les valeurs primitives deviennent null, boolean, number ou string. Les chaînes ressemblant à des dates, identifiants ou nombres restent des chaînes. Les jetons numériques sont classés sans conversion ; number ne garantit pas la précision numérique en JavaScript.
Les objets du même contexte sont regroupés. Une clé est facultative si elle manque dans au moins un objet du groupe. Un null explicite est une valeur : facultatif et nullable sont deux notions distinctes. Les objets vides comptent aussi.
Les tableaux combinent récursivement les éléments observés, sans créer de tuples de longueur fixe. Les tableaux vides peuvent utiliser les éléments de tableaux non vides du même contexte ; sans élément, le résultat est unknown[]. Les chemins de propriétés distincts ne partagent pas leurs données.
Le résultat est un alias de type exporté avec des types imbriqués en ligne, des clés entre guillemets et un formatage stable. Un pool d'objets sans clé utilise une signature d'index de chaîne valorisée unknown, qui est permissive plutôt qu'exactement vide. Aucune heuristique d'énumération, de discriminant, de dictionnaire, de date ou UUID n'est appliquée.
Exemples obligatoires, facultatifs et nullables
Dans l’exemple, le premier objet contient id 1, label Ada et score null ; le second contient id 2 et score 4. id et score figurent dans les deux objets et sont obligatoires. label apparaît une fois et devient facultatif. score combine null et number.
Pour un objet dont le champ left est un tableau vide et le champ right contient 1, left reste unknown[] et right devient number[] . Pour deux tableaux items correspondants, un vide et un contenant 1, leurs preuves d'éléments partagés produisent à la place number[] .
En fusionnant des objets avec kind ok et value et des objets avec kind error et message, kind devient une chaîne et value et message deviennent facultatifs. La relation initiale est perdue et des combinaisons non observées sont permises. Vérifiez ces cas si vous avez besoin d’une union discriminée.
Inférence et limites de taille
Un échantillon ne peut pas établir tous les futurs champs, valeurs manquantes ou variantes. Les déclarations générées sont des types au moment de la compilation, et non un validateur d'exécution, un schéma d'objet exact ou une preuve qu'une réponse d'API est correcte.
La saisie est limitée à 256 Ko de texte UTF-8, profondeur 32 et 20 000 enregistrements. Chaque valeur JSON compte une fois et chaque membre d'objet ajoute deux enregistrements supplémentaires. La sortie est limitée à 1 Mio, formatage compris et nouvelle ligne finale. Les limites rejettent toute l’opération sans résultat tronqué.
Un seul BOM initial est autorisé. Les noms dupliqués après décodage et les unités de substitution UTF-16 non appariées sont rejetés pour l’interopérabilité. Les jetons numériques sont limités à 1024 caractères et à un exposant de valeur absolue maximale 100000 ; bigint et la précision numérique ne sont pas garantis.
L'outil accepte le texte JSON et émet un alias de type. Il n'importe pas de fichiers ou d'URL, n'exécute pas d'échantillons, ne génère pas d'interfaces ou de code d'exécution, ne déduit pas de schéma JSON, ne traduit pas de clés ou n'installe pas de compilateur dans votre navigateur. Passez en revue les déclarations dans le projet TypeScript où vous les utiliserez.
Les exemples et le code restent dans le flux de travail de cette page
L’outil n’envoie pas l’échantillon à un serveur, ne conserve pas d’historique, ne crée pas de lien contenant les données et n’ajoute pas de télémétrie contenant le JSON, les clés, les noms de type ou le code généré. La copie et le téléchargement sont lancés à la demande. Les services existants du site, les extensions et l’usage ultérieur du code ne sont pas couverts par cette description.
Questions JSON vers TypeScript
Sources et références
- rfc-editor.orgRFC 8259Syntaxe JSON et interopérabilité.
- typescriptlang.orgTypeScript: Everyday TypesAlias, tableaux et unions TypeScript.
- typescriptlang.orgTypeScript: Object TypesPropriétés des objets et signatures d'index.
- typescriptlang.orgTypeScript: unknownLe type unknown pour les valeurs sans données observées.
- typescriptlang.orgTypeScript: Erased TypesLes déclarations de type ne fournissent pas de validation d'exécution.
Sources vérifiées le 2026-11-15. Le regroupement, les noms et les limites sont des choix de cet outil.
Outils associés
JSON en YAML
Convertissez localement JSON en YAML en conservant le texte des nombres et les chaînes entre guillemets ; copiez ou téléchargez le résultat complet.
Ouvrir l’outil — JSON en YAMLYAML en JSON
Convertissez localement du YAML en JSON avec des nombres exacts, des alias limités et une copie ou un téléchargement complet.
Ouvrir l’outil — YAML en JSONFormateur YAML
Ajustez l’indentation du YAML et copiez le résultat vérifié en conservant les commentaires et les détails du texte source.
Ouvrir l’outil — Formateur YAMLFormateur XML
Vérifiez le XML 1.0 et ses espaces de noms, formatez ou compactez localement, puis copiez ou téléchargez le résultat en UTF-8.
Ouvrir l’outil — Formateur XMLFormateur et validateur JSON
Vérifiez la syntaxe JSON, formatez ou minifiez localement, puis copiez ou téléchargez le résultat en conservant les données d’origine.
Ouvrir l’outil — Formateur et validateur JSON