Comment convertir un texte TOML en JSON

Pourquoi convertir du TOML en JSON ?

Cette conversion transforme un texte TOML en représentation JSON, ce qui facilite la lecture d’une configuration et la préparation de données destinées à un outil qui attend ce format. Elle prend en compte les chaînes, les nombres, les valeurs booléennes et les tables imbriquées. Vous pouvez aussi adapter la présentation du résultat en modifiant l’indentation numérique ou en activant le tri des clés. Ces réglages changent l’organisation visuelle de la représentation, sans remplacer le contenu TOML fourni.

Étapes de conversion

1. Préparez le texte TOML à convertir. Vérifiez les noms de clés, les valeurs et la structure des tables avant de le saisir. Les chaînes, nombres et valeurs booléennes sont convertis vers leurs types JSON correspondants, tandis que les tables imbriquées deviennent des structures imbriquées.

2. Saisissez le contenu dans le champ TOML. Cette entrée est facultative. Si elle est vide ou contient uniquement des espaces, l’opération réussit et renvoie la représentation d’un objet JSON vide. Ce comportement permet aussi de distinguer une absence de contenu d’un texte qui contient une erreur de syntaxe.

3. Ajustez l’indentation numérique si la présentation proposée ne vous convient pas. La valeur par défaut est de deux espaces. Activez le tri des clés lorsque vous souhaitez parcourir les propriétés selon un ordre organisé ; cette option est désactivée par défaut.

4. Lancez la conversion et examinez la représentation JSON obtenue. Pour les valeurs TOML de type date, heure ou date-heure, vérifiez qu’elles apparaissent comme des chaînes au format ISO. Si l’opération échoue, relisez d’abord la syntaxe TOML, puis réessayez avec le contenu corrigé.

Lire et vérifier le résultat

La représentation obtenue reflète les données et les niveaux de votre texte d’entrée. Une table située sous une autre apparaît comme un niveau JSON imbriqué ; une chaîne, un nombre ou une valeur booléenne conserve la catégorie de donnée correspondante. L’indentation sert à rendre cette structure plus facile à parcourir, alors que le tri des clés réorganise leur présentation lorsqu’il est activé.

Une entrée vide ne doit pas être interprétée comme une conversion manquante : elle produit la représentation d’un objet JSON vide. À l’inverse, un texte TOML mal formé ne fournit pas de représentation convertie. Une opération peut également échouer pendant la sérialisation JSON ; l’absence de résultat ne vient donc pas uniquement de la syntaxe TOML. Avant de réutiliser la sortie, contrôlez les chaînes ISO correspondant aux dates et aux heures ainsi que la structure des tables.

Exemple pratique

Vous contrôlez la structure d’une configuration de serveur avant de transmettre sa représentation JSON à un système qui attend ce format.

Saisissez serveur = { port = 8080, actif = true, lancement = 2024-01-15 }, conservez l’indentation proposée par défaut, puis lancez la conversion. Vérifiez que la sortie présente les trois propriétés sous « serveur » et que la date est une chaîne au format ISO.

La représentation JSON contient une structure imbriquée pour la table « serveur », les valeurs 8080 et true dans leurs catégories correspondantes, ainsi qu’une chaîne ISO pour la date.

Limites

• Un TOML mal formé ne produit pas de représentation convertie, et une défaillance pendant la sérialisation JSON peut également interrompre l’opération.

Erreurs fréquentes

• Cause : une clé, une valeur ou une table ne respecte pas la syntaxe TOML. Correction : relisez l’élément signalé dans votre contenu, corrigez sa forme, puis relancez la conversion.

Questions fréquentes

Que se passe-t-il si le champ TOML est vide ?

Lorsque le champ ne contient aucun caractère ou seulement des espaces, l’opération réussit et produit la représentation d’un objet JSON vide. Une entrée vide n’est donc pas traitée comme un TOML mal formé.

Pourquoi la conversion TOML vers JSON échoue-t-elle ?

Si le texte TOML est mal formé, aucune représentation convertie n’est produite. Corrigez alors la syntaxe des clés, valeurs ou tables concernées avant de relancer l’opération.

Puis-je contrôler la présentation du JSON ?

Vous pouvez modifier l’indentation numérique et activer le tri des clés avant de lancer l’opération. La première valeur proposée est de deux espaces, tandis que le tri est désactivé au départ.