Collez des déclarations TypeScript interface, alias type, enum ou classes et obtenez un document JSON d'exemple qui les satisfait. Les unions de littéraux, Record, les types utilitaires comme Pick, Omit et Partial, et les interfaces chaînées par extends sont tous suivis et remplis.
Utilisez-le avant qu'une API existe pour préparer des données fictives MSW ou json-server, pour créer des props Storybook, ou pour montrer à l'équipe backend exactement quelle forme vous voulez recevoir.
types.ts. export, import et des déclarations de fonctions peuvent s'y mêler ; seules les déclarations de types sont lues.enums référencés pour qu'ils soient remplis. Les noms de types absents de l'entrée deviennent null.type UserPage = Page<User>, est préféré à la déclaration générique elle-même.HttpResponse.json(...) d'un handler MSW, une fixture de test ou les args de Storybook, puis ajustez les valeurs.type Channel = "email" | "sms" | "push";
enum Priority { Low = "low", High = "high" }
interface Notification {
id: string;
channel: Channel;
priority: Priority;
recipient: { userId: number; locale?: string };
payload: Record<string, string>;
readAt: Date | null;
meta: Pick<Audit, "createdBy">;
}
interface Audit { createdBy: string; createdAt: Date }{
"id": "",
"channel": "email",
"priority": "low",
"recipient": {
"userId": 0,
"locale": ""
},
"payload": {
"key": ""
},
"readAt": "1970-01-01T00:00:00.000Z",
"meta": {
"createdBy": ""
}
}Channel est une union de littéraux chaîne : il prend sa première valeur, "email" ; l'enum de chaînes Priority prend la valeur de son premier membre, "low". Record<string, string> devient un objet à une seule clé "key", Date | null se résout vers le côté non nul sous forme de chaîne ISO, et Pick<Audit, "createdBy"> ne garde que la clé sélectionnée. Le locale? optionnel est inclus lui aussi.
string → "", number/bigint → 0, boolean → false, any/unknown → null, Date → 1970-01-01T00:00:00.000Z (le format de Date.toJSON()).null/undefined, et les intersections (A & B) ainsi que interface ... extends fusionnent les propriétés.enum utilise la valeur de son premier membre, ou 0 pour un enum numérique sans initialiseurs.Array<T> et Set<T> reçoivent un élément d'exemple ; les tuples reçoivent une valeur par position ; Record<K, V>, Map et les signatures d'index deviennent {"key": V}.Partial, Required, Readonly, NonNullable, Pick et Omit.static, les accesseurs get/set et les champs @Exclude() sont exclus.children: TreeNode[]) sont coupés en tableaux vides.Avant que le backend soit prêt, générez des données fictives à partir des types de réponse de l'API. L'interface peut être construite d'abord, et passer plus tard à la vraie API conserve les mêmes types.
Créez un objet par défaut à partir du type de props d'un composant pour les args d'une story ou les données de rendu de React Testing Library. Toutes les propriétés obligatoires sont présentes : aucune erreur de type à pourchasser.
Transformez un type de requête frontend en JSON et collez-le dans une doc de conception d'API ou un ticket : les développeurs backend qui n'utilisent pas TypeScript lisent la structure immédiatement.
?) sont toujours incluses ; supprimez vous-même des clés pour tester des réponses où elles sont absentes.type UserPage = Page<User>, items: T[] est rempli avec User, et les valeurs par défaut comme <T = string> s'appliquent quand aucun argument n'est donné. Les types conditionnels à l'intérieur des génériques ne sont toujours pas évalués.T["key"], les types conditionnels et les template literal types ne sont pas évalués.name = "kim", retries = 3) utilise cette valeur ; les autres initialiseurs comme new Date() ne servent qu'à indiquer le type.z.infer sous forme d'interface simple.Map et Set sont affichés comme un objet et un tableau, mais JSON.stringify les transforme tous deux en {} : préférez Record ou des tableaux dans les types de réponse.Date sorte en chaîne ?Oui. JSON.stringify remplace une Date par le résultat de son toJSON(), une chaîne ISO 8601. Le côté récepteur reçoit donc bien une chaîne : typez-la string ou analysez-la.
status: "active" | "inactive" ?Le premier littéral dans l'ordre de déclaration, "active". Réordonnez l'union si vous préférez afficher une autre valeur.
Les déclarations de classes et les décorateurs sont analysés : les DTO annotés avec des décorateurs class-validator se convertissent bien, et les champs @Exclude() de class-transformer sont omis.
Utilisez la page JSON → TypeScript pour le sens inverse. Des pages séparées génèrent aussi du JSON à partir de modèles TypeORM, Sequelize et Mongoose.