Présentation du Formateur JSON
Le Formateur JSON est un outil conçu pour formater, valider et minifier des données JSON instantanément. Il permet aux utilisateurs de coller directement du texte JSON dans une zone de saisie ou d'ouvrir des fichiers locaux afin d'effectuer diverses opérations de structuration et de nettoyage. Grâce à cet outil, vous pouvez appliquer différents niveaux d'indentation, éliminer les caractères inutiles par la minification ou encore trier les clés des objets.
L'outil propose également une arborescence interactive pour explorer la structure des données, tout en facilitant la correction des erreurs de syntaxe grâce à un système de détection et de prévisualisation des correctifs.
Méthodes d'importation et configuration des entrées
Pour commencer à travailler, l'outil accepte plusieurs types d'entrées et de paramètres de configuration:
- Coller du JSON: Vous pouvez coller directement votre texte JSON dans la zone de saisie prévue à cet effet.
- Ouverture de fichiers: En cliquant sur le bouton Ouvrir un fichier ou en utilisant le glisser-déposer, vous pouvez charger un fichier de type
.jsonou.txt. L'outil impose des règles strictes pour l'importation:- Seuls les fichiers
.jsonou.txtsont pris en charge. Si un autre format est sélectionné, le message « Type de fichier non pris en charge — choisissez un fichier .json ou .txt. » s'affiche. - Les fichiers doivent obligatoirement être encodés en UTF-8. Dans le cas contraire, l'outil affiche « Ce fichier n’est pas du texte UTF-8; il ne peut donc pas être ouvert ici. ».
- Une limite de taille maximale est appliquée. Si le fichier dépasse cette limite, le message « Le fichier est trop volumineux — la limite est de
{limit}. » apparaît. - En cas de problème de lecture, le message « Impossible de lire ce fichier. Essayez de le choisir de nouveau. » est présenté.
- Seuls les fichiers
- Niveau d'indentation: Vous pouvez sélectionner l'Indentation souhaitée pour la mise en forme du code.
- Sélection de la syntaxe: L'outil permet de choisir la Syntaxe appropriée entre « JSON » et « JSONC ».
- Recherche dans l'arborescence: Un champ de recherche permet de saisir une requête pour filtrer et localiser des éléments spécifiques dans la structure.
Traitement des données et limites techniques
Le traitement des données s'effectue selon des règles techniques précises afin de garantir la fidélité des informations et la stabilité du navigateur:
- Préservation des grands entiers: L'outil préserve les grands nombres entiers sans aucune perte de précision lors des manipulations.
- Gestion des clés en double: Contrairement aux outils qui fusionnent ou ignorent silencieusement les doublons, ce formateur génère une erreur lorsqu'une clé est dupliquée. Le message « Clé en double
{key}— retirez-en une avant de formater » s'affiche alors. - Limites de taille et de traitement:
- La taille maximale absolue de l'entrée est de 10 Mio. Si cette limite est dépassée, l'outil affiche « L’entrée dépasse
{limit}, soit plus que ce que cet outil peut traiter. ». - Le seuil de traitement synchrone est fixé à 250 000 caractères.
- Si l'analyse du document prend trop de temps, le processus est interrompu et affiche « La vérification de ce JSON a pris trop de temps et a été arrêtée. Essayez un document plus petit. ».
- La taille maximale absolue de l'entrée est de 10 Mio. Si cette limite est dépassée, l'outil affiche « L’entrée dépasse
Exploration et navigation avec l'arborescence
L'affichage sous forme d'Arborescence offre une structure interactive pour explorer visuellement vos données. Cet affichage comporte toutefois des limites de rendu et des fonctionnalités de navigation spécifiques:
- Restrictions d'affichage:
- Si le JSON saisi est invalide, l'onglet affiche « Corrigez le JSON pour le voir sous forme d’arborescence. ».
- Si le document est trop volumineux, le message « Ce JSON est trop volumineux pour s’afficher en arborescence. » ou « Ce JSON contient trop de valeurs pour être affiché en arborescence. » apparaît.
- Lors de l'utilisation du bouton Tout développer, si la structure est trop grande pour être entièrement déployée, l'affichage est limité et indique: « Ce JSON est trop volumineux pour être développé au complet — affichage des
{count}premières lignes. ». Vous pouvez alors utiliser le bouton Afficher{count}de plus….
- Navigation et recherche: Vous pouvez rechercher des clés et des valeurs grâce au champ « Rechercher dans les clés et les valeurs ». Les résultats sont indiqués sous la forme «
{current}sur{total}» ou «{current}sur{total}+ » en cas de dépassement du seuil maximal. S'il n'y a aucun résultat, la mention « Aucun résultat » s'affiche. Des boutons permettent de naviguer via « Résultat précédent » et « Résultat suivant ». - Contrôle des nœuds: Vous pouvez manipuler l'arborescence avec les boutons Tout développer, Tout réduire, ou individuellement avec « Développer
{key}» et « Réduire{key}». Le nœud racine est identifié par le libellé « racine ». - Options de copie ciblée: En accédant au menu « Options de copie pour
{key}», vous pouvez extraire précisément des données grâce aux options Copier la valeur, Copier le JSON Pointer ou Copier le JSONPath.
Validation, détection et correction des erreurs
L'outil valide la conformité de vos données et vous aide à corriger les erreurs de syntaxe les plus courantes.
Messages d'erreur de syntaxe
Si le JSON est invalide, l'outil affiche « JSON invalide » et localise le problème avec la mention « ligne {line}, colonne {col} ». Un bouton Aller à l’erreur permet de se positionner directement à l'endroit concerné. Parmi les erreurs détectées, on retrouve:
- « Virgule manquante entre les éléments »
- « Virgule en trop avant le crochet fermant »
- « Les clés d’objet doivent être entourées de guillemets doubles »
- « Deux-points manquant après un nom de propriété »
- « Une chaîne n’a pas de guillemet fermant »
- « Le JSON se termine trop tôt — il semble tronqué »
- « Caractère inattendu là où une valeur est attendue »
- « Ce JSON est imbriqué trop profondément pour être traité »
Détection de formats non standards et actions de correction
L'outil est capable d'identifier plusieurs structures non standards et propose des actions de réparation automatique via le bouton Prévisualiser le correctif:
| Format détecté | Message de détection | Action de correction appliquée |
|---|---|---|
| Bloc de code Markdown | « Ceci ressemble à du JSON dans un bloc de code Markdown. » | « L’application ne conserve que le JSON à l’intérieur du bloc. » |
| JSON échappé | « Ceci ressemble à du JSON échappé dans une chaîne. » | « L’application déséchappe la chaîne en JSON brut. » |
| Dictionnaire Python | « Ceci ressemble à un dictionnaire de style Python plutôt qu’à du JSON. » | « L’application réécrit les guillemets et True/False/None en JSON. » |
| JSON Lines | « Ceci ressemble à du JSON Lines — une valeur par ligne. » | « L’application regroupe les lignes en un seul tableau JSON. » |
| Rappel JSONP | « Ceci ressemble à du JSON enveloppé dans un rappel JSONP. » | « L’application retire l’enveloppe du rappel. » |
| JSONC | « Ceci ressemble à du JSONC — commentaires ou virgules finales. Passez la syntaxe à JSONC ou appliquez le correctif. » | « L’application retire les commentaires et les virgules finales. » |
Pour tout autre cas général, l'outil indique: « L’application remplace l’entrée par le JSON corrigé. ».
Application des correctifs
En cliquant sur Prévisualiser le correctif, l'interface ouvre l'Aperçu du correctif présentant l'Original et le résultat « Après le correctif ». Si le document est trop grand, la mention « Aperçu tronqué — le correctif s’applique au document au complet. » s'affiche.
Vous pouvez alors cliquer sur Appliquer le correctif ou sur Annuler. Une fois appliqué, le message « Correctif appliqué. Appuyez sur Ctrl/Cmd+Z pour annuler. » s'affiche. Si la réparation automatique échoue, l'outil indique: « Impossible de corriger automatiquement cette entrée. ».
Options de sortie et actions disponibles
Une fois vos données traitées, plusieurs actions et informations de sortie sont disponibles:
- Formatage et Minification: Vous pouvez cliquer sur Formater ou Minifier. L'outil affiche alors « JSON formaté. » ou « JSON minifié. ».
- Tri des clés: Le bouton Trier les clés permet de trier récursivement les clés des objets selon l'ordre des points de code, sans jamais modifier l'ordre des tableaux. L'infobulle d'aide précise: « Trie récursivement les clés des objets selon l’ordre des points de code. L’ordre des tableaux ne change jamais. ». Après l'opération, le message « Clés triées — l’ordre des tableaux demeure inchangé. Appuyez sur Ctrl/Cmd+Z pour annuler. » s'affiche.
- Statistiques en temps réel: L'interface affiche le nombre de Caractères, de Lignes ainsi que la Taille du document.
- Effacer l'éditeur: Le bouton Effacer vide la zone de saisie et affiche « Éditeur effacé. ».
- Téléchargement et copie: Vous pouvez copier le résultat dans votre presse-papiers (affichant « Copié dans le presse-papiers. ») ou cliquer sur Télécharger pour obtenir le fichier (affichant «
{name}téléchargé. »). - Messages d'état généraux:
- « Prêt. Collez du JSON et choisissez une action. »
- « Collez ou ouvrez d’abord du JSON. » (si vous tentez une action sur un éditeur vide).
- «
{name}chargé ({size}). » lors du chargement réussi d'un fichier.
FAQ (Foire aux questions)
Mon JSON est-il téléversé?
Non. Le formateur s’exécute de façon sécuritaire dans votre navigateur et ne téléverse pas votre JSON. Votre JSON est traité dans votre navigateur et rien n’est téléversé vers BroBroGo.
Que fait la minification?
La minification supprime les espaces et retours à la ligne inutiles sans changer les données JSON.