Comment valider, formater et minifier un fichier JSON ?

Valider, formater et minifier un fichier JSON sont trois opérations différentes. La validation vérifie que le document respecte la syntaxe JSON, le formatage améliore sa lisibilité et la minification supprime les espaces inutiles. Voici les méthodes les plus simples pour effectuer ces opérations.
✓ Vérifié le 9 octobre 2026 · 4 min de lecture

Les trois opérations à distinguer

Avant de modifier un fichier JSON, il est important de comprendre le rôle de chaque opération :

  • Valider : vérifier que le contenu respecte la syntaxe JSON.
  • Formater ou indenter : ajouter des retours à la ligne et des espaces pour faciliter la lecture.
  • Minifier : supprimer les espaces et les retours à la ligne inutiles afin de réduire la taille du fichier.

Le formatage et la minification ne remplacent pas la validation. Un fichier peut sembler correctement présenté tout en contenant une erreur de syntaxe.

Vérifier la syntaxe JSON

Un document JSON peut contenir des objets, des tableaux, des chaînes de caractères, des nombres, true, false et null. Les propriétés d’un objet utilisent des guillemets doubles et les virgules finales sont interdites.

Exemple de JSON valide

{
  "nom": "Outiko",
  "actif": true,
  "services": ["SEO", "Contenu"]
}

Erreurs fréquentes

Les chaînes JSON doivent utiliser des guillemets doubles :

{
  'nom': 'Outiko'
}

Cette version est invalide. Une virgule finale rend également le document invalide :

{
  "nom": "Outiko",
}

Les noms de propriétés devraient aussi être uniques dans un même objet. Avec des doublons, le résultat peut varier selon l’outil utilisé.

Valider un JSON avec JavaScript

En JavaScript, JSON.parse() analyse une chaîne selon la grammaire JSON. En cas d’erreur, la méthode déclenche une exception SyntaxError.

const contenu = '{"nom":"Outiko","actif":true}';

try {
  const donnees = JSON.parse(contenu);
  console.log("JSON valide", donnees);
} catch (erreur) {
  console.error("JSON invalide :", erreur.message);
}

Cette méthode contrôle uniquement la syntaxe. Elle ne vérifie pas automatiquement la présence des champs attendus ni les règles métier appliquées à leurs valeurs.

Formater un fichier JSON avec JavaScript

Pour formater un JSON, commencez par le parser puis utilisez JSON.stringify(). Son troisième argument définit le niveau d’indentation. La valeur 2 correspond à deux espaces.

const contenu = '{"nom":"Outiko","actif":true,"services":["SEO","Contenu"]}';

const donnees = JSON.parse(contenu);
const jsonFormate = JSON.stringify(donnees, null, 2);

console.log(jsonFormate);

Le résultat sera indenté ainsi :

{
  "nom": "Outiko",
  "actif": true,
  "services": [
    "SEO",
    "Contenu"
  ]
}

Minifier un JSON avec JavaScript

Pour obtenir une version compacte, appelez JSON.stringify() sans argument d’indentation :

const donnees = {
  nom: "Outiko",
  actif: true,
  services: ["SEO", "Contenu"]
};

const jsonMinifie = JSON.stringify(donnees);

console.log(jsonMinifie);

Résultat :

{"nom":"Outiko","actif":true,"services":["SEO","Contenu"]}

La minification supprime uniquement les espaces de présentation. Elle ne doit pas modifier les valeurs du document.

Valider et formater un JSON avec jq

jq est un outil en ligne de commande qui permet de lire, vérifier, filtrer et produire des données JSON.

Valider et formater

Pour vérifier et afficher un fichier avec une indentation lisible :

jq . fichier.json

Pour enregistrer le résultat dans un autre fichier :

jq . fichier.json > fichier-formate.json

Si le contenu n’est pas valide, jq renvoie une erreur.

Minifier avec jq

L’option -c, ou --compact-output, produit une sortie compacte :

jq -c . fichier.json > fichier-minifie.json

Contrôler un fichier dans un script

if jq empty fichier.json >/dev/null 2>&1; then
  echo "JSON valide"
else
  echo "JSON invalide"
fi

Vérifier la structure avec JSON Schema

Un JSON peut être syntaxiquement valide tout en ne respectant pas la structure attendue par une application. JSON Schema permet alors de définir les types, les propriétés obligatoires, les propriétés autorisées et les contraintes sur les chaînes, les nombres, les objets et les tableaux.

Il faut distinguer :

  1. le document JSON à contrôler, appelé instance ;
  2. le schéma qui décrit les règles attendues ;
  3. le validateur qui compare l’instance au schéma.

Exemple de schéma :

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "nom": {
      "type": "string"
    },
    "actif": {
      "type": "boolean"
    }
  },
  "required": ["nom", "actif"]
}

Avec ce schéma, un document sans propriété nom ou contenant une chaîne à la place d’une valeur booléenne pour actif peut être refusé, même s’il est syntaxiquement valide.

Procédure recommandée

  1. Conservez une copie du fichier original.
  2. Validez sa syntaxe avec JSON.parse(), jq ou un outil équivalent.
  3. Formatez-le pour faciliter la relecture et la maintenance.
  4. Utilisez JSON Schema si des règles de structure ou de métier doivent être contrôlées.
  5. Corrigez les erreurs signalées puis relancez la validation.
  6. Minifiez uniquement la version destinée à la transmission ou à la production.
  7. Conservez une version formatée dans le dépôt ou la documentation.

À retenir

  • JSON.parse() valide une chaîne JSON en JavaScript.
  • JSON.stringify(donnees, null, 2) produit un JSON indenté.
  • JSON.stringify(donnees) produit une version compacte.
  • jq . fichier.json valide et formate un fichier.
  • jq -c . fichier.json produit une sortie minifiée.
  • JSON Schema vérifie la structure et les contraintes, au-delà de la simple syntaxe.

Questions fréquentes

Quelle est la différence entre valider et formater un fichier JSON ?
Valider consiste à vérifier que le contenu respecte la syntaxe JSON. Formater consiste à ajouter une indentation et des retours à la ligne pour le rendre plus lisible. Le formatage ne corrige pas nécessairement une erreur de syntaxe.
Comment savoir rapidement si un JSON est valide ?
En JavaScript, utilisez JSON.parse() dans un bloc try...catch. En ligne de commande, utilisez jq . fichier.json. Ces méthodes signalent les erreurs de syntaxe.
La minification modifie-t-elle les données JSON ?
Non. Une minification correcte supprime seulement les espaces, les retours à la ligne et l’indentation qui servent à la présentation. Les valeurs et la structure restent identiques.
Pourquoi utiliser JSON Schema si le fichier JSON est déjà valide ?
La validation syntaxique vérifie uniquement que le document est correctement écrit. JSON Schema permet en plus de contrôler les types, les champs obligatoires, les propriétés autorisées et d’autres règles de structure.