Code

Formater du JSON : vérifier la syntaxe et lire la structure

·

Formater du JSON rend un document compact plus facile à relire. La vérification de syntaxe, l’indentation, la minification et l’exploration de l’arbre répondent à des besoins différents : choisissez l’action qui convient avant de récupérer le résultat.

Ce guide précise ce que l’outil conserve et ce qu’il refuse. Le résultat reprend les tokens numériques d’origine au lieu de sérialiser les valeurs Number du parseur ; une application destinataire peut toutefois les interpréter autrement. Le texte complet et son arbre ont aussi des limites différentes.

Formater du JSON

Charger le document puis choisir une action

Collez le document dans « Entrée », cliquez sur « Ouvrir un fichier texte » pour un fichier local ou sur « Essayer un exemple ». Choisissez l’« Indentation » et l’ordre des clés, puis « Formater le JSON » ou « Minifier ».

Les actions portent sur toute l’entrée, même si une partie est sélectionnée. Le formatage ajoute des espaces de présentation ; la minification retire ceux qui sont inutiles hors des chaînes. Relisez « Résultat » et les avertissements avant de copier ou de télécharger.

  • Chargez le document entier, pas seulement la sélection.
  • Choisissez une indentation de 2 ou 4 espaces et l’ordre des clés.
  • Formatez pour relire ou minifiez pour supprimer les espaces de présentation.
  • Corrigez la syntaxe et examinez les propriétés répétées.
  • Explorez l’arbre et les pointeurs pour situer une valeur.
  • Copiez ou téléchargez toute la sortie et gardez une copie hors de l’onglet.

node-jsonc-parser : analyse et formatage

Vérifier la syntaxe du JSON strict

Le validateur JSON accepte un seul objet, tableau ou scalaire complet. Les noms de propriétés et les chaînes exigent des guillemets doubles. Les commentaires, les virgules finales et tout contenu supplémentaire après la première valeur sont refusés.

L’outil ne répare pas le document, ne convertit pas JSON5 et n’assemble pas plusieurs lignes NDJSON. Pour indenter du JSON, il faut d’abord un document syntaxiquement valide ; une autre mise en page ne corrige pas sa grammaire.

Vérifier la syntaxe du JSON strict
Exemple d’entréeAccepté ici ?Signification
{"ready":true}OuiObjet JSON avec nom entre guillemets et valeur booléenne.
[3,2,1]OuiTableau dont l’ordre des éléments est conservé.
"hello", 42, true, nullOuiChacun peut constituer une valeur complète à la racine.
Champ vide ou composé seulement d’espacesNonIl n’y a aucune valeur JSON.
{"a":1,} ou [1,]NonLes virgules finales sont refusées.
{/* note */"a":1}NonLes commentaires sont refusés.
{a:1}, {'a':1}, NaN, InfinityNonCes formes ne sont pas du JSON strict accepté.
{"a":1} {"a":2}NonDeux enregistrements distincts ne forment pas un seul document JSON.

RFC 8259 : syntaxe et interopérabilité JSON

Comprendre la première erreur

Le message indique la première erreur avec une ligne et une colonne commençant à 1. Les colonnes comptent des unités UTF-16 : un caractère hors du plan multilingue de base en occupe deux, même s’il paraît unique à l’écran.

Dans { "a": }, la fermeture inattendue se trouve à la ligne 2, colonne 8. Corrigez l’entrée puis recommencez pour découvrir d’éventuelles erreurs suivantes. Il s’agit d’une vérification syntaxique, sans validation par JSON Schema ni contrôle des règles métier.

node-jsonc-parser : analyse et formatage

Conserver les grands entiers et les échappements JSON

Le formatage reprend les fragments source des nombres et des chaînes. Il conserve donc les chiffres d’un grand entier, l’écriture d’un exposant, les zéros décimaux, le zéro négatif et les échappements. Pour produire cette sortie, il utilise l’écriture source plutôt que la sérialisation des valeurs JavaScript Number de l’analyseur.

Cette propriété concerne le texte produit ici. Un logiciel destinataire peut arrondir un entier, obtenir une valeur infinie ou réécrire une chaîne à la sérialisation. Contrôlez les littéraux importants dans le système qui utilisera le résultat.

Conserver les grands entiers et les échappements JSON
Token ou propriété sourceCe que conserve RésultatCe qui n’est pas garanti
9007199254740993Les chiffres d’origine.Un calcul exact dans tous les logiciels destinataires.
1e400Le token d’exposant d’origine.Une valeur finie pour un destinataire utilisant binary64.
1e+09 et 1.2300L’écriture de l’exposant et des décimales.Une représentation normalisée unique.
-0Le signe moins et le zéro.La même écriture dans un autre sérialiseur.
"\u0061"L’écriture échappée originale de la chaîne.Une recherche du texte de l’échappement plutôt que de la valeur décodée.
"a":1,"\u0061":2Les deux propriétés et leur écriture.Des noms décodés ou des pointeurs uniques.

RFC 8259 : syntaxe et interopérabilité JSONECMAScript : JSON.parse

Repérer et conserver les clés JSON répétées

Les doublons sont signalés et restent des propriétés distinctes dans le résultat. La comparaison porte sur les noms décodés : "a" et "\u0061" désignent la même clé malgré leur écriture différente.

Aucune propriété n’est supprimée et aucune valeur gagnante n’est choisie. Une autre application peut ne garder que la dernière valeur. Examinez ces avertissements avant d’utiliser le document comme configuration ou de l’envoyer à une API.

RFC 8259 : syntaxe et interopérabilité JSON

Trier récursivement les clés selon UTF-16

Dans « Trier les clés des objets », choisissez « Garder l’ordre d’origine », « Croissant (UTF-16) » ou « Décroissant (UTF-16) ». Les noms décodés sont comparés par unités UTF-16, sans tri linguistique ni comparaison naturelle des nombres.

Les objets sont triés récursivement, y compris dans les tableaux. L’ordre des éléments d’un tableau reste inchangé ; les noms décodés identiques gardent leur ordre relatif. En ordre croissant, "10" précède "2". Ce tri ne constitue pas une canonicalisation suffisante pour signer le document.

Explorer l’arbre JSON

Après traitement, « Explorer l’arbre JSON » ouvre la structure. Dépliez ou repliez les objets et tableaux ; une branche présente d’abord au plus 100 enfants, puis permet d’en afficher jusqu’à 100 de plus par lot.

Les feuilles numériques et les chaînes montrent leur écriture source ; les conteneurs indiquent le nombre d’enfants. « Masquer l’arbre JSON » revient au texte sans modifier le résultat. « Réinitialiser l’arbre » efface la recherche et rétablit les branches initiales. Modifier l’entrée efface l’ancien résultat et ferme son arbre ; seul un nouveau traitement réussi produit un nouveau résultat.

Copier les pointeurs JSON et comprendre ~0 et ~1

Le libellé de la racine est $, mais son pointeur réel est la chaîne vide. Les niveaux sont séparés par /. À l’intérieur d’un nom, un tilde devient ~0 et une barre oblique devient ~1.

« Copier le pointeur » copie ce chemin. Si le presse-papiers est indisponible, un pointeur non vide peut être sélectionné manuellement ; le pointeur vide de la racine n’a pas de substitut visible à copier. Des propriétés ayant le même nom décodé partagent le même pointeur : RFC 6901 indique que son évaluation est indéfinie et échoue. L’outil affiche et copie ces chemins sans résoudre ce conflit.

Copier les pointeurs JSON et comprendre ~0 et ~1
Nœud ou cléExemple de pointeurInterprétation
Racine du documentChaîne vide, notée ici ""Copier le pointeur copie zéro caractère, ni $ ni guillemets.
Clé name de l’objet racine/nameUn niveau de membre d’objet.
Clé a/b~c de l’objet racine/a~1b~0cLa barre oblique et le tilde du nom sont échappés.
Premier élément sous cette clé de tableau/a~1b~0c/0Le zéro final est un indice de tableau.
Deux propriétés racine décodées en a/a pour les deuxLe doublon rend le pointeur ambigu.

RFC 6901 : pointeurs JSON

La recherche trouve des sous-chaînes sans tenir compte de la casse dans les libellés, les chemins et les valeurs de chaîne décodées. On peut ainsi retrouver "\u0061" avec a. Pour les autres feuilles, la recherche utilise leur représentation littérale.

La requête est limitée à 1000 unités UTF-16. Le total compte toutes les correspondances, tandis que la liste n’en affiche que les 100 premières ; précisez votre recherche pour réduire ce nombre. Cette recherche ne modifie pas le JSON et reste distincte de celle du champ Entrée.

Séparer les limites du texte, du fichier et de l’arbre

L’entrée est mesurée en unités UTF-16 et le fichier local en octets avant lecture. Un même caractère visible peut occuper plusieurs unités et plusieurs octets. Un fichier assez petit peut donc encore dépasser la limite du texte décodé.

L’arbre possède ses propres budgets de nœuds et de texte. Un objet avec une propriété scalaire compte quatre nœuds syntaxiques : l’objet, la propriété, son nom et sa valeur. Si l’arbre ne tient pas dans ces budgets, Résultat conserve le texte complet. Respecter les limites ne garantit pas un délai de traitement.

Séparer les limites du texte, du fichier et de l’arbre
LimiteRègle actuelleConséquence pratique
Entrée et texte importé décodéAu plus 1,000,000 unités UTF-16.La limite exacte est acceptée ; divisez un texte plus long.
Octets du fichier localStrictement moins de 4,000,000 octets.Un fichier de 4,000,000 octets exactement est refusé.
Imbrication JSONAu plus 256 conteneurs imbriqués.Une profondeur supérieure est refusée avant le formatage.
Nœuds syntaxiques de l’arbreAu plus 10,000 nœuds de l’analyseur.Cela ne signifie pas 10,000 propriétés autorisées.
Budget de texte de l’arbreAu plus 2,000,000 unités UTF-16 cumulées de libellés, chemins et littéraux des feuilles.L’arbre peut être absent et Résultat rester complet.
Enfants visibles par branche100 au départ, puis par lots d’au plus 100.Affichez les éléments suivants pour en voir davantage.
Recherche dans l’arbreRequête d’au plus 1,000 unités UTF-16 ; les 100 premières correspondances sont affichées.Le total peut dépasser la liste visible.
Historique de l’entréeAu plus 20 états antérieurs et 4,000,000 unités UTF-16 cumulées du passé et du futur, hors entrée actuelle.Des états anciens peuvent disparaître ; ce n’est pas un stockage durable.

Ouvrir un fichier texte UTF-8 comme JSON

« Ouvrir un fichier texte » lit le fichier local comme texte UTF-8 puis vérifie sa longueur décodée. Aucun autre encodage n’est détecté automatiquement ; ce n’est pas un lecteur PDF ou DOCX. Le fichier doit faire moins de 4000000 octets et le texte décodé au plus 1000000 unités UTF-16.

Une URL écrite dans le document ne déclenche aucun téléchargement. En cas de refus ou d’échec de lecture, conservez l’original hors de l’onglet et préparez un fichier texte plus petit ou correctement encodé.

MDN : lecture de Blob en texte UTF-8

Copier et télécharger le résultat JSON complet

« Copier le résultat » et « Télécharger » récupèrent toute la sortie, quelle que soit la sélection. Le téléchargement contient du texte UTF-8 sous le nom toolmellow-result.json. Si le presse-papiers échoue, sélectionnez le texte puis copiez-le manuellement.

L’indentation peut agrandir la sortie au-delà de 1000000 unités UTF-16 : cette limite d’entrée ne borne pas la sortie. Vous pouvez la copier ou la télécharger. « Utiliser le résultat comme entrée » refuse une sortie trop longue et garde les deux champs ; si elle est acceptée, l’entrée est remplacée et le résultat effacé, avec annulation possible dans les limites de l’historique.

Rechercher, remplacer et annuler dans l’entrée

« Rechercher et remplacer dans le texte » travaille sur toute l’entrée. La recherche est littérale et « Respecter la casse » est initialement désactivé : . n’est pas une expression régulière et $& dans « Remplacer par » reste du texte littéral. La recherche admet 1000 unités UTF-16, le remplacement 10000 ; « Tout remplacer » est refusé si l’entrée deviendrait trop longue.

Un collage natif trop long est refusé en entier. Le contrôle soustrait la sélection remplacée et normalise CRLF ou CR en LF avant de compter. « Annuler la modification » et « Rétablir » conservent au plus 20 états antérieurs et 4000000 unités UTF-16 cumulées entre passé et futur, sans l’entrée actuelle ; les états les plus anciens peuvent être abandonnés.

Effacer, annuler un traitement et rester dans l’onglet

« Effacer » supprime l’entrée, le résultat, les recherches et l’historique, mais conserve les options. Cette action est irréversible par l’historique. Aucune sauvegarde automatique ni restauration après fermeture n’est promise : enregistrez ce que vous souhaitez conserver.

« Annuler » arrête le traitement en cours sans changer l’entrée originale. Un worker local effectue le calcul avec un délai de 60 secondes incluant son démarrage. Une erreur de démarrage, une expiration ou un échec du moteur peut nécessiter une entrée plus petite ou un rechargement.

Le traitement du JSON n’envoie pas son contenu à un service de conversion et n’exécute pas les données comme du code. Les ressources de la page peuvent nécessiter le réseau au chargement. Cela ne promet ni utilisation hors connexion, ni suppression des secrets, ni certification de sécurité ; les URL du document ne sont pas consultées.

Contrôler la mise en page avant de transmettre

En gardant l’ordre d’origine, le formatage choisit le premier saut de ligne réel CRLF, CR ou LF qui lui parvient ; sans saut réel, il utilise LF. Le tri des clés reconstruit d’abord une source compacte : le formatage qui suit utilise donc LF. Les échappements écrits \r et \n dans une chaîne ne sont pas des sauts réels.

Les champs du navigateur peuvent normaliser les sauts, les espaces extérieurs sont retirés et un scalaire ou un conteneur vide peut ne créer aucune ligne supplémentaire. « Retour à la ligne » ne change que l’affichage du champ, pas les octets JSON. Vérifiez les littéraux, les doublons, l’ordre et le fichier final dans l’application destinataire.

RFC 8259 : syntaxe et interopérabilité JSONRFC 6901 : pointeurs JSON

Questions fréquentes

Les grands entiers et l’écriture des échappements sont-ils conservés ?

Oui. Les tokens d’origine de nombres et de chaînes sont conservés, notamment 9007199254740993, 1e400, -0 et "\u0061". Une autre application peut les interpréter ou les sérialiser autrement.

Les clés JSON répétées sont-elles supprimées ?

Non. Les noms décodés répétés sont signalés, mais toutes les propriétés restent présentes. Un logiciel destinataire peut ne conserver que la dernière valeur.

Puis-je traiter seulement une sélection ?

Les actions traitent toute Entrée ; la copie et le téléchargement portent sur tout Résultat. Une sélection permet les commandes ordinaires de copie du navigateur.

Pourquoi les commentaires et les virgules finales sont-ils refusés ?

Le traitement exige du JSON strict. Il ne répare pas les commentaires, les virgules finales, JSON5 ou plusieurs enregistrements NDJSON.

Une valeur scalaire peut-elle être le document complet ?

Oui. Une seule chaîne, un nombre, un booléen ou null peut être à la racine, comme un objet ou un tableau. Un champ vide n’est pas une valeur JSON.

Comment les clés sont-elles triées et l’ordre des tableaux conservé ?

Le tri récursif compare les noms décodés par UTF-16. Il garde l’ordre des éléments des tableaux et l’ordre relatif des clés décodées identiques.

Pourquoi l’arbre manque-t-il alors que le résultat est complet ?

L’arbre est limité à 10000 nœuds syntaxiques et 2000000 unités UTF-16 de texte cumulé. Son absence pour dépassement de budget ne tronque pas Résultat.

Quelles limites concernent la saisie, les fichiers et l’imbrication ?

L’entrée admet 1000000 unités UTF-16 au maximum, limite incluse. Un fichier doit faire moins de 4000000 octets ; l’imbrication maximale est de 256 conteneurs. Octets et unités UTF-16 sont des mesures distinctes.

Pourquoi une sortie longue ne peut-elle pas redevenir une entrée ?

L’indentation peut dépasser le plafond d’entrée. Copiez ou téléchargez la sortie ; Utiliser le résultat comme entrée la refuse sans changer les deux champs si elle est trop longue.

Le validateur JSON vérifie-t-il aussi un JSON Schema ?

Non. L’outil vérifie la syntaxe d’une valeur JSON complète, pas les types attendus, les champs obligatoires ou les autres contraintes d’un schéma.

La recherche accepte-t-elle les expressions régulières ?

Non. Elle est littérale, avec une option pour la casse. Le point reste un point et $& est inséré tel quel dans le remplacement.

Que signifient ~0 et ~1 dans un pointeur JSON ?

~0 désigne un tilde et ~1 une barre oblique à l’intérieur d’un nom. Le pointeur racine est vide, pas $. En présence d’un nom répété, son évaluation est indéfinie et échoue.

Une URL dans le JSON est-elle ouverte ?

Non. Le contenu est traité comme des données locales, sans exécution du JSON ni récupération de ses URL. Le chargement des ressources de la page peut demander le réseau.

Puis-je annuler Effacer et le texte est-il conservé en quittant ?

Effacer ne peut pas être annulé : l’historique est supprimé aussi, mais les options sont gardées. Le texte n’est pas sauvegardé automatiquement en quittant ; conservez votre propre copie.

Références principales

Passez à la pratique.

Guides associés