JSON → TypeScript

Transformez un exemple JSON en interfaces ou types TypeScript directement dans votre navigateur.

À propos de JSON → TypeScript

De quoi s’agit-il

JSON → TypeScript lit un exemple JSON — une réponse d’API, une configuration, des données de test — et écrit les déclarations TypeScript qui le décrivent. Les objets imbriqués deviennent des types nommés, les formes des éléments d’un tableau sont fusionnées et les champs qui ne sont pas toujours présents sont marqués optionnels : vous obtenez une base typée au lieu de tout écrire à la main.

Fonctionnalités principales

  • Déclarations en interface ou en type, avec ou sans export.
  • Objets imbriqués extraits en types nommés, ou laissés en ligne.
  • Les éléments de tableau de formes différentes sont fusionnés en un seul type ; un champ absent de certains éléments devient optionnel.
  • Nom du type racine au choix.
  • Champs readonly, tous les champs optionnels et exemples JSDoc tirés des valeurs.

Comment l’utiliser

  1. Collez du JSON dans l’éditeur, déposez-y un fichier ou cliquez sur « Exemple ».
  2. Choisissez « Interface » ou « Type » et indiquez le nom du type racine.
  3. Activez ce dont vous avez besoin : types imbriqués extraits, champs readonly, champs optionnels, JSDoc.
  4. Copiez le TypeScript ou envoyez-le vers un autre outil.

Quand c’est utile

  • Typer une réponse d’API avant de l’utiliser dans un frontend.
  • Décrire un fichier de configuration chargé à l’exécution.
  • Obtenir un brouillon de types pour un webhook tiers à partir d’un vrai payload.

Confidentialité et limites

Vos données

Votre JSON est converti dans votre navigateur et n’est pas envoyé à un serveur — le site reçoit seulement un événement anonyme « outil ouvert », sans le contenu. Un résultat envoyé vers un autre outil reste 24 heures sur cet appareil dans « Activité récente ».

Limites

  • Les types ne décrivent que l’exemple fourni : un champ qui n’y figure jamais ne sera pas dans le résultat.
  • Une valeur null dans l’exemple est typée null — ajoutez le vrai type vous-même si vous le connaissez.

Questions fréquentes

Faut-il choisir « Interface » ou « Type » ?

Les deux décrivent la même forme. Les interfaces peuvent être étendues et fusionnées ; type est pratique pour les unions et les alias. Si votre projet a une convention, suivez-la.

Comment les tableaux d’objets sont-ils traités ?

Les formes de tous les éléments sont fusionnées en un seul type. Un champ présent dans certains éléments et absent des autres devient optionnel, pour que le type convienne à chaque élément.

Pourquoi ai-je une erreur au lieu des types ?

L’entrée doit être un JSON valide. Vérifiez-la avec le Formateur JSON, qui indique la ligne et la position de l’erreur.