# Schéma JSON vers TypeScript

Convertissez un schéma JSON en types TypeScript. Les objets deviennent des interfaces avec des propriétés obligatoires et facultatives ; $defs et les définitions deviennent des exportations nommées vers lesquelles $ref pointe ; enum et const deviennent des types littéraux ; anyOf et oneOf deviennent des unions, et allOf une intersection. Les descriptions sont conservées sous forme de commentaires de documentation.

## Foire aux questions

### Quels brouillons de schéma JSON sont pris en charge ?

Le convertisseur lit les mots-clés communs à draft-07, 2019-09 et 2020-12 : type, properties, required, additionalProperties, items, prefixItems, enum, const, anyOf, oneOf, allOf, ainsi que $ref vers $defs ou definitions. Les mots-clés de validation tels que minLength ou pattern n’ont pas d’équivalent TypeScript et sont omis.

### Comment les références $ref sont-elles résolues ?

Les références vers #, #/$defs/Name et #/definitions/Name deviennent le type nommé de cette définition. Toute autre référence, comme une référence vers un autre fichier ou un URL, est typée unknown et indiquée dans un commentaire en tête de la sortie.

### Comment additionalProperties est-il géré ?

Un objet sans propriétés et avec un schéma additionalProperties devient Record<string, T>. Un objet avec des propriétés et un schéma additionalProperties devient l’interface combinée à Record<string, T>. additionalProperties false ou un mot-clé absent n’ajoute rien, car les types d’objet TypeScript décrivent déjà les clés connues.

### Que fait nullable ?

Le mot-clé nullable: true d’OpenAPI 3.0 et l’extension x-nullable de Swagger ajoutent | null au type. Dans le schéma JSON lui-même, écrivez type: ["string", "null"] pour obtenir string | null.

### Les schémas récursifs sont-ils pris en charge ?

Oui. Une définition qui se référence elle-même ou en référence une autre via $ref devient un type nommé qui fait référence à l’autre nom, que TypeScript résout sans problème.

### Vérifie-t-il que mon schéma est valide ?

Il lit uniquement le schéma. Les mots-clés inconnus sont ignorés et un schéma sans type devient unknown. Utilisez le validateur de schéma JSON pour vérifier des données par rapport à un schéma.

Votre publicité ici ?

[Envoyez-nous un e-mail](mailto:hi@dennn.is?subject=Publicit%C3%A9%20sur%20OneClick%20Pro)

[Annonce 433 outils pour vos agents IA via un seul serveur MCP.](https://multitaskai.com/fr/?ref=oneclickpro)
