5 erreurs de syntaxe JSON courantes et comment les corriger

# 5 erreurs de syntaxe JSON courantes et comment les corriger

JSON (JavaScript Object Notation) est partout dans le développement web moderne - des réponses API aux fichiers de configuration. Malgré sa syntaxe simple, les développeurs rencontrent constamment des erreurs JSON frustrantes qui cassent les applications.

Ce guide couvre les 5 erreurs de syntaxe JSON les plus courantes que vous rencontrerez, comment les identifier instantanément et comment les corriger définitivement.

---

Pourquoi les erreurs JSON sont si courantes

Les exigences syntaxiques strictes de JSON signifient qu'un seul caractère mal placé peut invalider un document entier. Contrairement à JavaScript, JSON :

• ✅ Requiert des guillemets doubles pour les chaînes (les guillemets simples sont invalides)
• ✅ Interdit les virgules traînantes
• ✅ Impose un formatage exact pour les clés et les valeurs
• ✅ N'autorise aucun commentaire

Plongeons dans les erreurs qui perturbent le plus fréquemment les développeurs.

---

Erreur #1 : Virgules traînantes (Le tueur silencieux)

Le problème

Les virgules traînantes - virgules supplémentaires après le dernier élément d'un tableau ou d'un objet - sont parfaitement valides en JavaScript mais complètement interdites en JSON.

❌ JSON invalide

{
  "username": "alice123",
  "email": "alice@example.com",
  "active": true,
}

{
  "products": [
    { "id": 1, "name": "Laptop" },
    { "id": 2, "name": "Mouse" },
    { "id": 3, "name": "Keyboard" },
  ]
}

✅ JSON valide

{
  "username": "alice123",
  "email": "alice@example.com",
  "active": true
}

{
  "products": [
    { "id": 1, "name": "Laptop" },
    { "id": 2, "name": "Mouse" },
    { "id": 3, "name": "Keyboard" }
  ]
}

Message d'erreur que vous verrez

Unexpected token } in JSON at position 78
SyntaxError: Trailing comma in JSON

Comment le corriger

Correction manuelle :

Recherchez les virgules avant les accolades fermantes } ou les crochets ]

Supprimez toutes les virgules traînantes

Validez avec un linter JSON

Astuce de prévention : Utilisez un formateur JSON comme BigJSON qui détecte et met en évidence automatiquement les virgules traînantes. Conseil de pro pour les développeurs :

// Dans votre éditeur de code, recherchez ces motifs :
,\s}   // Virgule avant l'accolade fermante

,\s]   // Virgule avant le crochet fermant

---

Erreur #2 : Guillemets simples au lieu de doubles

Le problème

JavaScript autorise à la fois les guillemets simples et doubles pour les chaînes, mais JSON n'accepte que les guillemets doubles ("). L'utilisation de guillemets simples est l'une des erreurs les plus courantes lors de la conversion d'objets JavaScript en JSON.

❌ JSON invalide

{
  'name': 'John Doe',
  'age': 30,
  'city': 'New York'
}

✅ JSON valide

{
  "name": "John Doe",
  "age": 30,
  "city": "New York"
}

Message d'erreur que vous verrez

Unexpected token ' in JSON at position 2
SyntaxError: Expected property name or '}' in JSON

Comment le corriger

Correction rapide :

// JavaScript : Convertir simple en double
const fixedJson = invalidJson.replace(/'/g, '"');

Meilleure approche : Utilisez la sérialisation JSON appropriée :

// Au lieu d'écrire manuellement JSON avec des guillemets :
const wrong = "{ 'name': 'John' }";  // ❌

// Utilisez JSON.stringify() :
const obj = { name: 'John' };
const correct = JSON.stringify(obj);  // ✅

---

Erreur #3 : Clés sans guillemets

Le problème

En JavaScript, les clés d'objet peuvent être sans guillemets si ce sont des identifiants valides. JSON exige que toutes les clés soient des chaînes entre guillemets doubles.

❌ JSON invalide

{
  name: "Alice",
  age: 28,
  isActive: true
}

✅ JSON valide

{
  "name": "Alice",
  "age": 28,
  "isActive": true
}

Message d'erreur que vous verrez

Unexpected token n in JSON at position 4
SyntaxError: Expected property name enclosed in double quotes

Comment le corriger

Utilisateurs de Visual Studio Code :

Installez l'extension "JSON"

Formatez votre document (Shift + Alt + F)

VS Code mettra en évidence les clés sans guillemets en rouge

---

Erreur #4 : Séquences d'échappement invalides

Le problème

JSON prend en charge des séquences d'échappement limitées. L'utilisation de séquences invalides ou l'oubli d'échapper des caractères spéciaux provoque des erreurs d'analyse.

❌ JSON invalide

{
  "path": "C:\Users\Alice\Documents",
  "message": "Line 1
Line 2"
}

✅ JSON valide

{
  "path": "C:\\Users\\Alice\\Documents",
  "message": "Line 1\nLine 2"
}

Séquences d'échappement valides en JSON

| Caractère | Séquence d'échappement | Description |

|-----------|----------------|-------------|

| " | \" | Guillemet double |

| \ | \\ | Barre oblique inverse |

| / | \/ | Barre oblique |

| Nouvelle ligne | \n | Saut de ligne |

| Tabulation | \t | Tabulation horizontale |

| Unicode | \uXXXX | Caractère Unicode |

---

Erreur #5 : Commentaires dans JSON (JSON ≠ JavaScript !)

Le problème

Les développeurs ajoutent souvent des commentaires aux fichiers JSON pour la documentation, mais JSON ne prend pas en charge les commentaires de quelque type que ce soit. Ni //, ni / /.

❌ JSON invalide

{
  // Configuration utilisateur
  "username": "admin",
  "role": "superuser",
  "debugMode": true
}

✅ JSON valide (aucun commentaire autorisé)

{
  "username": "admin",
  "role": "superuser",
  "debugMode": true
}

Solutions de contournement

Option 1 : Utilisez un champ de commentaire

{
  "_comment": "Configuration utilisateur - mettre à jour avant la production",
  "username": "admin",
  "role": "superuser",
  "debugMode": true
}

Option 2 : Utilisez JSON5 ou JSONC

Pour les fichiers de configuration, envisagez :

• JSON5 : Prend en charge les commentaires, les virgules traînantes et plus
• JSONC : JSON avec commentaires (utilisé dans VS Code)

---

Bonus : Comment détecter les erreurs JSON tôt

1. Utilisez des validateurs en ligne

BigJSON Validator - Validation instantanée avec messages d'erreur utiles

2. Extensions IDE

VS Code :

• Validation JSON intégrée
• Installez "Error Lens" pour les messages d'erreur en ligne

3. Hooks pre-commit

# .git/hooks/pre-commit
#!/bin/bash
for file in $(git diff --cached --name-only | grep -E '\.json$'); do
  if ! python -m json.tool "$file" > /dev/null 2>&1; then
    echo "Invalid JSON in $file"
    exit 1
  fi
done

---

Référence rapide : Liste de contrôle de détection des erreurs

Avant de soumettre ou de déployer des fichiers JSON, vérifiez :

• [ ] Pas de virgules traînantes après les derniers éléments
• [ ] Toutes les chaînes utilisent des guillemets doubles (")
• [ ] Toutes les clés d'objet sont entre guillemets
• [ ] Les caractères spéciaux sont correctement échappés
• [ ] Aucun commentaire nulle part
• [ ] Imbrication appropriée des accolades et des crochets
• [ ] Types de données valides (chaîne, nombre, booléen, null, objet, tableau)

---

Outils pour prévenir les erreurs JSON

1. Outils en ligne BigJSON

Visitez BigJSON pour :

• Formateur : Correction automatique des problèmes de formatage
• Validateur : Vérification instantanée de la syntaxe
• Minifieur : Suppression des espaces pour la production

2. Outils en ligne de commande

# Validateur intégré Node.js
node -e "JSON.parse(require('fs').readFileSync('file.json'))"

# Validateur Python
python -m json.tool file.json

# jq (processeur JSON)
jq . file.json

---

Conclusion

Les 5 erreurs de syntaxe JSON les plus courantes sont :

Virgules traînantes - Supprimez les virgules avant } et ]

Guillemets simples - Utilisez toujours des guillemets doubles (")

Clés sans guillemets - Mettez toutes les clés d'objet entre guillemets

Séquences d'échappement invalides - Utilisez les bonnes séquences d'échappement

Commentaires - Supprimez tous les commentaires (utilisez JSON5 si nécessaire)

Rappelez-vous : JSON n'est pas JavaScript ! Sa syntaxe stricte ne laisse aucune place à la flexibilité.

Prochaines étapes

Validez votre JSON : Utilisez BigJSON Validator

Formatez automatiquement : Utilisez BigJSON Formatter

Apprenez-en plus : Lisez notre Guide JSON complet

---

Ressources connexes

• Erreurs JSON courantes et comment les corriger
• Comment formater les fichiers JSON
• Outil de validation JSON
• Formateur JSON en ligne

---

Dernière mise à jour : 15 février 2026