JSON

Qu'est-ce que JSON ?

JSON (JavaScript Object Notation) est un format d'échange de données léger et textuel, facile à lire et à écrire pour les humains, et simple à analyser et à générer pour les machines. Bien qu'issu de JavaScript, JSON est indépendant du langage et constitue désormais le standard de facto pour l'échange de données sur le Web.

JSON représente les données sous forme de paires clé-valeur organisées en objets et en tableaux. Sa simplicité en a fait le format dominant pour les API REST, les fichiers de configuration et le stockage de données.

Bref historique

JSON a été formalisé par Douglas Crockford au début des années 2000. La spécification a été publiée sur json.org en 2001. La RFC 4627 a suivi en 2006, et l'actuel standard ECMA-404 en 2013.

Avant JSON, XML était le format d'échange de données dominant sur le Web. Le minimalisme de JSON — sans attributs, instructions de traitement ni espaces de noms — l'a rendu immédiatement populaire. Dès 2010, JSON avait largement supplanté XML pour les API Web.

Types de données JSON

JSON prend en charge exactement six types de données. Chaque valeur dans un document JSON valide doit être l'un d'eux :

{
  "string":  "hello world",
  "number":  42,
  "float":   3.14,
  "boolean": true,
  "null":    null,
  "array":   [1, 2, 3],
  "object":  { "nested": "value" }
}

Règles de syntaxe JSON

JSON a des règles de syntaxe strictes. Un léger écart provoque une erreur d'analyse. Voici les six règles les plus importantes :

JSON invalide vs. valide

{
  'name': 'Alice',       // single quotes — invalid
  age: 30,              // unquoted key — invalid
  "scores": [1, 2, 3,], // trailing comma — invalid
  "note": undefined     // undefined — invalid
}

{
  "name": "Alice",
  "age": 30,
  "scores": [1, 2, 3],
  "note": null
}

JSON dans le Web moderne

API REST

JSON est le format de corps standard pour les requêtes et réponses d'API REST. Pratiquement tous les langages de programmation disposent d'un analyseur JSON intégré.

Fichiers de configuration

package.json, tsconfig.json, .eslintrc et de nombreux autres outils de développement utilisent JSON pour la configuration.

Bases de données NoSQL

Les bases de données documentaires comme MongoDB, CouchDB et Amazon DynamoDB stockent les données sous forme de documents JSON.

État et données frontend

localStorage et sessionStorage stockent des chaînes, donc JSON.stringify/JSON.parse sont constamment utilisés pour sérialiser les objets JavaScript.

JSON vs. autres formats

JSON n'est pas toujours le meilleur choix. Voici comment il se compare aux autres formats de données courants :

JSON Schema

JSON Schema est un vocabulaire permettant de valider la structure des documents JSON. Un schéma décrit les types attendus, les champs obligatoires et les contraintes d'une valeur JSON.

Des outils comme ajv (JavaScript), jsonschema (Python) et les validateurs intégrés dans de nombreux IDE prennent en charge JSON Schema. OpenAPI utilise JSON Schema pour décrire les corps de requêtes et réponses d'API.

Pièges courants de JSON

Questions fréquentes