Qu’est-ce que JSON ? Un guide du débutant avec des exemples

Si vous avez touché à une API, à un fichier de configuration ou au développement Web moderne, vous avez rencontré JSON. C'est le format de facto pour l'échange de données entre systèmes : suffisamment lisible pour les humains, suffisamment strict pour les machines. Voici une présentation adaptée aux débutants de ce que c'est et comment l'utiliser.

Qu'est-ce que JSON

JSON signifie JavaScript Object Notation. Malgré son nom, il est indépendant du langage : pratiquement tous les langages de programmation peuvent le lire et l'écrire. Il représente les données sous forme de paires clé-valeur et de listes ordonnées, qui, ensemble, peuvent décrire presque toutes les données structurées.

Un exemple simple

{
"name": "Ada Lovelace",
"age": 36,
"isMathematician": true,
"langues": ["Anglais", "Français"]
}

C'est un objet avec quatre clés. Notez les types de données : une chaîne entre guillemets, un nombre, un booléen et un tableau de chaînes. JSON prend en charge les chaînes, les nombres, les booléens, les valeurs nulles, les objets et les tableaux : c'est tout le vocabulaire.

Les règles qui font trébucher les gens

• Les clés doivent être entre guillemets doubles : les guillemets simples ne sont pas valides.
• Aucune virgule finale : une virgule après le dernier élément le rompt.
• Aucun commentaire : JSON n'a pas de syntaxe de commentaire (une surprise fréquente).
• Les chaînes utilisent uniquement des guillemets doubles, jamais simples.

Ces petites règles provoquent la plupart des erreurs « JSON invalide ». La grammaire officielle est définie sur json.org.

Comment lire et réparer un JSON désordonné

Les API renvoient le JSON minifié sur une seule ligne, ce qui est illisible. Collez-le dans notre formateur JSON pour obtenir une sortie propre et indentée, ainsi qu'un message d'erreur instantané identifiant toute erreur de syntaxe. C'est le moyen le plus rapide de déboguer une charge utile mal formée.

Où vous rencontrerez JSON

Les réponses API, les fichiers de configuration (comme package.json), la charge utile d'un JWT, les bases de données NoSQL et le navigateur localStorage utilisent tous JSON. Une fois que vous pouvez le lire confortablement, une énorme quantité d'outils modernes s'ouvre.

JSON contre XML

JSON a largement remplacé XML pour les API Web, car il est plus léger et plus facile à lire. XML apparaît toujours dans certains contextes d'entreprise et de documents, mais pour les nouveaux travaux Web, JSON est la valeur par défaut. Si vous devez passer d'un format à l'autre, nos convertisseurs s'en chargent également.

Imbrication : comment les données réelles sont structurées

Les exemples ci-dessus sont simples, mais le vrai JSON imbrique les objets et les tableaux les uns dans les autres pour modéliser des données complexes. Un objet utilisateur peut contenir un objet « adresse » et un tableau de « commandes », chaque commande étant elle-même un objet. Cette imbrication est ce qui permet à JSON de décrire presque tout – mais c'est aussi là que la lisibilité en souffre, car un JSON minifié profondément imbriqué est impossible à suivre à l'oeil nu. C'est exactement à ce moment-là qu'un formatteur gagne sa place, indentant chaque niveau afin que la structure devienne visible d'un seul coup d'œil.

Erreurs JSON courantes et comment les corriger

La plupart des échecs de type « JSON invalide » proviennent d'une petite poignée d'erreurs : une virgule après le dernier élément, des guillemets simples au lieu de doubles, une clé sans guillemets ou un commentaire parasite. Ce qui est frustrant, c'est qu'un mauvais caractère invalide l'ensemble du document et que le message d'erreur peut pointer vers le mauvais endroit. Coller dans un validateur qui met en évidence la ligne exacte permet de gagner du temps réel : il identifie la virgule ou la citation qu'un œil humain saute.

JSON au-delà des API

Une fois que vous serez à l'aise avec la lecture de JSON, vous le repérerez partout : fichiers de configuration tels que package.json, définitions d'infrastructure, bases de données NoSQL telles que MongoDB, localStorage du navigateur et charges utiles contenues dans les JWT. C'est devenu la lingua franca de l'échange de données précisément parce qu'il est simple, lisible par l'homme et pris en charge partout. La maîtrise de JSON débloque discrètement une énorme quantité d'outils modernes.

Résultat

JSON est un moyen simple et universel de représenter des données structurées avec des clés, des valeurs et des tableaux. Apprenez la poignée de règles strictes – guillemets doubles, pas de virgules finales, pas de commentaires – et appuyez-vous sur un formateur pour les valider et les ranger. C'est l'un des formats les plus utiles à maîtriser. Pour plus d'aide au quotidien, consultez notre boîte à outils pour les développeurs Web.