Qu’est-ce que le JSON

Les deux conteneurs : objets et tableaux

Tout, dans le JSON, se construit à partir de deux structures. Un objet est un ensemble non ordonné de paires clé/valeur enveloppées dans des accolades — les clés sont toujours des chaînes, les valeurs peuvent être n’importe quelle valeur JSON, et les paires sont séparées par des virgules. Un tableau est une liste ordonnée de valeurs enveloppée dans des crochets, et ses valeurs peuvent mêler tous les types.

{
  "name": "Ada Lovelace",
  "born": 1815,
  "mathematician": true
}

[
  "analytical engine",
  1843,
  null
]

Les six types de données

Quatre sont des scalaires — string, number, boolean et null — et deux sont les conteneurs ci-dessus. Les règles qui surprennent les débutants sont peu nombreuses mais strictes : les chaînes sont toujours entre guillemets doubles (les guillemets simples sont invalides), les nombres n’ont pas besoin de guillemets et ne peuvent pas s’écrire en hexadécimal, les booléens sont exactement les tokens minuscules true et false, et null est une valeur à part entière qui signifie vide délibérément.

L’échappement : ce qui peut vivre dans une chaîne

Dans une chaîne, deux caractères doivent être échappés partout où ils apparaissent : le guillemet double (sous la forme \") et l’antislash (sous la forme \\). Six autres séquences d’échappement existent pour les caractères de contrôle — \n nouvelle ligne, \t tabulation, \r retour chariot, \b retour arrière, \f saut de page, et \/ pour la barre oblique, ce qui est légal mais facultatif. Tout autre caractère peut apparaître littéralement en UTF-8, ou comme séquence d’échappement \uXXXX pour son point de code Unicode — les deux formes signifient exactement la même chaîne pour un analyseur.

"path": "C:\\Users\\ada"
"quote": "she said \"hi\""
"emoji": "\ud83d\ude00"

path:   C:\Users\ada
quote:  she said "hi"
emoji:  😀

Espaces, formatage et pourquoi on formate

Entre la ponctuation structurelle, le JSON n’autorise que quatre caractères d’espacement : l’espace, la tabulation, la nouvelle ligne et le retour chariot. Cette liberté est ce qui rend le formatage possible — le même document peut être une seule ligne illisible sur le fil et un arbre indenté dans votre éditeur, et tous deux sont, octet pour octet, les mêmes données pour un analyseur. Le formatage ne change rien au sens, et c’est pourquoi l’outil de formatage peut s’exécuter sans risque sur n’importe quelle charge utile, et pourquoi le JSON minifié est le choix standard pour le transport.

• Pas de commentaires : la RFC 8259 les a retirés délibérément, après des divergences bien réelles entre analyseurs. JSONC est l’extension non officielle que certains outils acceptent.
• Pas de virgules finales : [1, 2, 3,] est invalide, si amical qu’il paraisse.
• Clés dupliquées : les analyseurs conservent soit la première, soit la dernière — la RFC 8259 laisse ce choix aux implémentations, et c’est pourquoi les doublons constituent un bug même quand l’analyse passe.
• N’importe quel niveau racine : n’importe quelle valeur peut constituer un document entier — un tableau de nombres est du JSON complet.

Où le JSON s’utilise — et où il ne s’utilise pas

Le JSON règne sur trois territoires : les corps de requêtes et de réponses d’API, la configuration structurée où l’absence de commentaires ne se regrette pas, et les données au repos dans les bases de données documentaires. Il partage le fil à contrecœur avec deux voisins — les formats binaires comme protobuf, qui gagnent en taille et en vitesse quand les deux bouts partagent un schéma, et YAML, qui gagne en facilité d’édition à la main pour la configuration des ops. Bien comprendre le JSON n’est donc pas une compétence parmi d’autres ; c’est le prérequis pour lire ces deux voisins, car YAML 1.2 analyse le JSON et la plupart des schémas binaires se documentent avec des exemples JSON.