Qu’est-ce que le JSON ? Erreurs courantes et solutions

Un guide clair sur le JSON : sa structure, les règles de syntaxe qui piègent tout le monde et un moyen rapide de trouver et corriger les erreurs.

Développement 7 min de lecture

Si vous avez déjà travaillé avec une API, un fichier de configuration ou un export de données, vous avez croisé le JSON. Il paraît simple, mais une seule virgule mal placée suffit à invalider tout le fichier et à afficher un message d’erreur cryptique.

Dans ce guide, vous allez apprendre ce qu’est le JSON, les types de valeurs qu’il accepte, les règles de syntaxe, les erreurs les plus courantes avec des exemples avant et après, et comment valider, formater et minifier vos données en quelques secondes.

Validez et formatez votre JSON maintenant Collez votre JSON pour trouver les erreurs, le mettre en forme ou le minifier. Tout se passe dans votre navigateur, rien n’est envoyé. Ouvrir le formateur JSON

Qu’est-ce que le JSON ?

Le JSON (JavaScript Object Notation) est un format texte léger pour stocker et échanger des données. Les données sont organisées en paires clé et valeur, par exemple {"nom": "Ana", "age": 30}. Il est facile à lire pour les humains et facile à analyser pour les programmes.

Bien qu’il soit né avec JavaScript, le JSON est indépendant du langage. C’est le format standard par lequel les API web échangent des données entre serveurs et applications, et il est aussi très répandu dans les fichiers de configuration, les journaux et les exports.

Les six types de valeurs

Toute valeur JSON est de l’un de ces six types :

  • Chaîne (string) : du texte entre guillemets doubles, comme "bonjour".
  • Nombre : entier ou décimal, comme 42 ou 3.14, sans guillemets.
  • Booléen : true ou false, en minuscules et sans guillemets.
  • Null : le mot null, qui signifie "aucune valeur".
  • Tableau (array) : une liste ordonnée entre crochets, comme [1, 2, 3].
  • Objet : un ensemble de paires clé et valeur entre accolades, comme {"ville": "Lyon"}. Les clés sont toujours des chaînes.

Les tableaux et les objets peuvent contenir d’autres tableaux et objets, ce qui permet de décrire des données de n’importe quelle profondeur.

Les règles de syntaxe à retenir

Le JSON est bien plus strict que JavaScript. La plupart des erreurs viennent du non-respect de l’une de ces règles :

  • Les chaînes et les clés doivent utiliser des guillemets doubles. Les guillemets simples sont interdits.
  • Pas de virgule finale : le dernier élément d’un tableau ou d’un objet ne doit pas être suivi d’une virgule.
  • Pas de commentaires : ni // ni /* */ ne sont valides.
  • Seuls les six types existent : undefined, NaN, Infinity et les fonctions sont invalides.
  • Les paires sont séparées par des virgules, et la clé est séparée de la valeur par deux-points.
  • Chaque accolade ou crochet ouvert doit avoir sa fermeture.

Les erreurs les plus courantes et comment les corriger

Ces cinq erreurs expliquent la grande majorité des messages « JSON invalide » :

  • Virgule finale. Avant : {"a": 1, "b": 2,}. Après : {"a": 1, "b": 2}. Supprimez la virgule après le dernier élément.
  • Guillemets simples. Avant : {'nom': 'Ana'}. Après : {"nom": "Ana"}. Remplacez tous les guillemets simples par des guillemets doubles.
  • Clé sans guillemets. Avant : {nom: "Ana"}. Après : {"nom": "Ana"}. Mettez chaque clé entre guillemets doubles.
  • Crochet ou accolade manquant. Avant : {"items": [1, 2, 3}. Après : {"items": [1, 2, 3]}. Fermez chaque tableau et chaque objet que vous ouvrez.
  • Mauvais échappement des guillemets. Avant : {"texte": "Il a dit "salut""}. Après : {"texte": "Il a dit \"salut\""}. Un guillemet double à l’intérieur d’une chaîne doit être précédé d’une barre oblique inverse. Il en va de même pour la barre elle-même, qui s’écrit \\.

Méfiez-vous aussi des guillemets typographiques copiés depuis un traitement de texte : ils ressemblent à des guillemets mais ne sont pas valides en JSON.

Comment lire un message d’erreur JSON

La plupart des analyseurs indiquent où ils se sont perdus, avec des messages comme "Unexpected token } in JSON at position 25" ou "Expected double-quoted property name at line 3 column 5". La position est un nombre de caractères depuis le début, tandis que la ligne et la colonne désignent l’endroit exact.

La vraie erreur se trouve souvent juste avant la position indiquée. Une accolade fermante inattendue signale généralement une virgule finale juste avant, et une fin de données inattendue indique un crochet non fermé. Regardez la ligne indiquée et celle du dessus.

Comment valider, formater et minifier du JSON

  1. Ouvrez le formateur JSON gratuit. Il fonctionne entièrement dans votre navigateur, vos données ne quittent donc pas votre appareil.
  2. Collez votre JSON. S’il est invalide, l’outil affiche l’erreur avec sa ligne et sa colonne pour que vous puissiez la corriger.
  3. Utilisez la mise en forme pour indenter et rendre lisible, ou minifiez pour supprimer les espaces et réduire la taille avant l’envoi.
  4. Copiez le résultat. Si vous avez modifié un fichier et voulez voir précisément ce qui a changé, comparez les deux versions avec l’outil de comparaison de texte.

JSON, XML et YAML

Le XML est plus verbeux, avec ses balises ouvrantes et fermantes, mais il gère les attributs et reste courant dans les systèmes anciens. Le YAML est plus lisible pour les humains et accepte les commentaires, ce qui explique sa popularité dans les fichiers de configuration, mais son indentation est facile à rater.

Le JSON se place entre les deux : compact, sans ambiguïté et pris en charge par pratiquement tous les langages, ce qui en fait le choix par défaut pour les API. Son principal inconvénient est l’absence de commentaires.

Conseils pratiques

  • Validez toujours le JSON avant de l’envoyer ou de l’enregistrer dans un fichier de configuration.
  • Utilisez un éditeur avec coloration syntaxique JSON, qui signale tout de suite les guillemets et crochets mal appariés.
  • N’écrivez pas du JSON à la main quand vous pouvez le générer par code : les bibliothèques échappent correctement les caractères.
  • Si un paramètre d’URL contient du JSON, encodez-le d’abord avec l’encodeur d’URL pour que les caractères spéciaux ne cassent pas la requête.
  • Ne collez jamais de mots de passe ni de jetons dans des outils en ligne qui envoient les données. Préférez les outils qui fonctionnent en local.

Conclusion

Le JSON est simple quand on connaît ses règles : six types de valeurs, guillemets doubles, pas de virgule finale et pas de commentaires. Quand quelque chose casse, lisez la ligne et la colonne de l’erreur, vérifiez l’endroit juste avant et laissez un validateur faire le gros du travail. Quelques secondes avec un formateur font gagner beaucoup de temps de débogage.

Questions fréquentes

À quoi sert le JSON ?

Il sert à échanger des données entre applications, surtout les API web, et à stocker des réglages et des données structurées dans des fichiers. Presque tous les langages de programmation savent le lire et l’écrire.

Le JSON peut-il contenir des commentaires ?

Non. Le JSON standard n’autorise pas les commentaires. Si vous avez besoin de notes, ajoutez un champ ordinaire comme "commentaire" ou utilisez un format comme le YAML pour les fichiers de configuration.

Pourquoi mon JSON affiche-t-il « unexpected token » ?

L’analyseur a rencontré un caractère inattendu, le plus souvent une virgule finale, un guillemet simple, une clé sans guillemets ou un crochet manquant. Vérifiez la position indiquée et la ligne juste au-dessus.

Quelle différence entre formater et minifier du JSON ?

Formater ajoute des retours à la ligne et de l’indentation pour la lisibilité. Minifier supprime tous les espaces inutiles pour alléger le fichier. Les données restent strictement identiques.

Est-il sûr d’utiliser un formateur JSON en ligne ?

C’est sûr quand l’outil fonctionne dans votre navigateur et n’envoie pas le contenu à un serveur. Notre formateur JSON traite tout localement sur votre appareil.

Outils gratuits mentionnés dans cet article

Continuer la lecture

Tous les articles