Comment formater un texte JSON correctement

À quoi sert le formateur JSON ?

Ce formateur JSON sert à rendre un texte JSON plus lisible et à vérifier qu’il peut être analysé correctement. Vous pouvez choisir le niveau d’indentation, trier facultativement les clés des objets et demander une sortie compacte selon le résultat recherché. L’entrée accepte du texte JSON et peut aussi rester vide, auquel cas aucune donnée JSON n’est fournie.

Comment formater et vérifier un texte JSON

1. Préparez le contenu à traiter sous forme de texte JSON, puis collez-le dans le champ prévu à cet effet. Pour vérifier un document, utilisez une structure JSON complète, par exemple un objet ou un tableau correctement délimité.

2. Réglez l’indentation si vous souhaitez contrôler le nombre d’espaces utilisé dans le résultat. La valeur proposée par défaut est de 2 espaces. Activez le tri des clés uniquement si vous voulez que les clés des objets soient ordonnées dans le texte formaté.

3. Activez la sortie compacte lorsque vous préférez une représentation sans indentation, avec des séparateurs compacts entre les virgules et les deux-points. Sinon, laissez cette option désactivée pour obtenir un texte plus aéré.

4. Lancez le traitement, puis examinez le texte JSON produit et l’état de l’opération. Si le contenu est valide, récupérez la version formatée selon les réglages choisis. Les caractères Unicode présents dans un JSON valide peuvent être conservés dans le texte obtenu.

5. Si le traitement signale une erreur d’analyse, relisez le détail fourni et corrigez le texte envoyé. Après correction, relancez le traitement avec le même réglage ou avec une indentation différente, selon votre besoin.

Comment lire le résultat

Un traitement réussi avec du contenu indique qu’un texte JSON a pu être analysé et qu’un texte formaté a été produit. La présentation dépend alors de l’indentation, du tri éventuel des clés et du choix de la sortie compacte. Le tri concerne l’ordre des clés dans les objets ; il ne constitue pas une transformation générale des données JSON.

Un échec d’analyse signifie que le texte n’a pas été reconnu comme JSON valide. Le contenu soumis est alors conservé comme contenu retourné et des détails d’erreur d’analyse sont inclus : utilisez-les pour localiser la correction à effectuer. À l’inverse, une entrée vide ou composée uniquement d’espaces est traitée comme une opération réussie sans contenu formaté et signale qu’aucune entrée JSON n’a été fournie.

Le formateur vérifie donc la possibilité d’analyser le texte et en produit une représentation formatée. Il ne faut pas interpréter ce résultat comme une validation de schéma ou comme une vérification métier des valeurs.

Exemple pratique

Vous souhaitez rendre lisible un petit objet JSON contenant un prénom accentué et un âge.

Collez ce texte JSON : {"nom":"Zoé","age":31}. Laissez l’indentation à 2, gardez le tri des clés et la sortie compacte désactivés, puis lancez le traitement.

Le résultat réussi contient un texte JSON formaté représentant un objet avec les clés « nom » et « age », selon l’indentation choisie ; les caractères accentués peuvent rester présents.

Limites

• Le résultat porte sur l’analyse du texte JSON et sa mise en forme ; il ne vérifie pas un schéma ni les règles métier de vos données.

Erreurs fréquentes

• Une virgule, une accolade, un crochet ou un guillemet mal placé peut rendre le JSON impossible à analyser. Corrigez la structure indiquée par les détails d’erreur, puis relancez le traitement.

Questions fréquentes

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

Une entrée vide ou composée uniquement d’espaces est traitée comme réussie, mais aucun contenu formaté n’est produit et le résultat indique qu’aucune entrée JSON n’a été fournie.

Les caractères accentués sont-ils conservés ?

Oui, si le JSON est valide, les caractères Unicode peuvent être conservés dans le texte formaté.

Que faire si le JSON est refusé ?

Lorsque l’analyse échoue, le texte soumis est conservé comme contenu retourné et des détails d’erreur sont inclus. Corrigez la structure du JSON avant de relancer le traitement.