Formateur JSON

Remettez en forme un JSON illisible, minifiez-le pour l'envoyer ou trouvez la ligne fautive. Vos données ne quittent pas le navigateur.

Collez du JSON, puis cliquez sur Formater. Raccourci : Ctrl ou Cmd + Entrée.

Indentation
Options

Mode d'emploi

  1. Collez le JSON dans la zone de saisie, ou cliquez sur Ouvrir un fichier pour choisir un fichier .json.
  2. Cliquez sur Formater pour l'indenter, ou sur Minifier pour retirer les espaces et les retours à la ligne.
  3. En cas d'erreur, l'outil indique la ligne, la colonne et la cause. Cliquez sur Aller à l'erreur pour vous y rendre.

Les règles du JSON

Le JSON est défini par la RFC 8259 (décembre 2017). Il ne connaît que sept types de valeurs : objet {}, tableau [], chaîne, nombre, true, false et null, ces trois mots toujours en minuscules. N’importe quelle valeur peut se trouver au premier niveau, donc "bonjour" ou 42 seuls sont déjà du JSON valide.

  • Chaînes : entre guillemets droits doubles. Le guillemet, la barre oblique inverse et les caractères de contrôle U+0000 à U+001F (retour à la ligne compris) doivent être échappés, par exemple \", \\, \n ou \u00e9.
  • Nombres : en décimal, sans zéro initial, sans signe plus, avec un point décimal. 0.5 et 1e-3 sont valides ; .5, 1., 007, 0,5, 0x1F, NaN et Infinity ne le sont pas.
  • Espaces : seuls l’espace, la tabulation, le saut de ligne et le retour chariot sont admis, autour de { } [ ] : ,.
  • Noms : ils devraient être uniques dans un objet. S’ils se répètent, la RFC précise que le comportement du logiciel qui reçoit l’objet est imprévisible. JSON.parse garde la dernière valeur ; cet outil conserve les deux en formatant.

Le JSON échangé entre systèmes ouverts doit être en UTF-8, sans indicateur d’ordre des octets (BOM) au début. L’outil supprime le BOM s’il en trouve un.

Les erreurs les plus fréquentes

  • Virgule finale : [1, 2,] → [1, 2]
  • Apostrophes : {'a': 'b'} → {"a": "b"}
  • Nom sans guillemets : {a: 1} → {"a": 1}
  • Guillemets français : {«a»: 1} → {"a": 1}
  • Valeurs Python : True, None → true, null
  • Virgule décimale : {"prix": 9,95} → {"prix": 9.95}
  • Chemin Windows : "C:\dossier" → "C:\\dossier"

L’outil vérifie le texte caractère par caractère : il peut donc nommer la cause et pas seulement la position. Pour {"a": 1 "b": 2}, il affiche Ligne 1, colonne 9 : Il manque une virgule entre deux valeurs. Un True venu de Python reçoit Écrivez true en minuscules. Une virgule décimale dans un tableau est plus sournoise : [9,95] est valide, mais contient deux nombres, 9 et 95.

Le JSON n’est pas un objet JavaScript

Il ressemble à un littéral d’objet JavaScript, mais il est bien plus strict. JavaScript accepte les noms sans guillemets, les apostrophes, la virgule finale, les commentaires, undefined, les fonctions et les nombres hexadécimaux ; le JSON n’en accepte aucun. L’inverse fonctionne : depuis ES2019, tout texte JSON valide est aussi une expression JavaScript valide.

Grands nombres et ordre des clés

Formater et Minifier ne touchent qu’aux espaces. Dans {"id":12345678901234567890,"prix":25000.50}, les deux nombres restent tels quels. Avec JSON.parse, l’identifiant deviendrait 12345678901234567000 et le prix 25000.5, car les nombres JavaScript ne sont exacts que jusqu’à 253 − 1. Le tri des clés suit l’ordre des codes de caractères : majuscules avant minuscules, et é après z.

Questions fréquentes

Mon JSON est-il envoyé à un serveur ?
Non. Tout se passe dans votre navigateur, vous pouvez donc l’utiliser avec des fichiers de configuration, des réponses d’API ou des données contenant des jetons.
Les grands nombres et les caractères spéciaux changent-ils ?
Non. L’outil ne fait que réorganiser les espaces sans toucher au contenu : les nombres longs, comme un identifiant à 19 chiffres, et les échappements comme \u00e9 restent exactement tels quels. Un formateur qui passe par JSON.parse transforme 12345678901234567890 en 12345678901234567000.
Quelles sont les erreurs les plus fréquentes ?
Une virgule après le dernier élément d’une liste ou d’un objet, des apostrophes au lieu de guillemets doubles, des noms de propriété sans guillemets, des commentaires et des valeurs comme undefined ou True. Rien de tout cela n’est autorisé en JSON standard.
Pourquoi mes guillemets sont-ils refusés ?
Le JSON n’accepte que le guillemet droit double ("). Les guillemets français « », les guillemets courbes “ ” et l’apostrophe sont refusés. Un traitement de texte remplace souvent les guillemets droits automatiquement : collez le JSON depuis un éditeur de code ou un fichier texte brut.
Puis-je valider un JSON avec commentaires, comme tsconfig.json ?
Vous pouvez l’ouvrir, mais il sera signalé comme invalide, car le JSON standard de la RFC 8259 n’a pas de commentaires. Des fichiers comme tsconfig.json sont lus par des analyseurs qui les acceptent. Retirez les commentaires si vous avez besoin d’un JSON valide.
Quelle taille de fichier l’outil accepte-t-il ?
On peut ouvrir des fichiers jusqu’à 50 Mo, et un fichier de quelques Mo est généralement traité sans attente notable. Au-delà d’un million de caractères, la vérification automatique pendant la saisie est désactivée ; cliquez sur Formater ou Valider pour vérifier le texte.