Aide-mémoire de syntaxe JSON

Les six caractères structurels

Six caractères de ponctuation portent toute la structure du JSON : les accolades { } qui enveloppent les objets, les crochets [ ] qui enveloppent les tableaux, le deux-points : qui sépare une clé de sa valeur, et la virgule , qui sépare les paires dans un objet ou les valeurs dans un tableau. Rien d’autre dans la grammaire ne fait de travail structurel — chaque autre caractère d’un document est soit dans une chaîne, soit l’un des quatre caractères d’espacement. Une virgule est strictement un séparateur : elle peut apparaître entre deux éléments, jamais avant une accolade ou un crochet fermant.

{"name":"Ada","tags":["math","pioneer"]}

{"name":"Ada","tags":["math","pioneer"],}

L’espacement : exactement quatre caractères

Hors des chaînes, le JSON n’autorise que quatre caractères d’espacement : l’espace (U+0020), la tabulation horizontale (U+0009), le saut de ligne (U+000A) et le retour chariot (U+000D). Tout le reste — tabulation verticale, saut de page, espace insécable, marque d’ordre des octets — est une erreur de syntaxe, même si beaucoup d’éditeurs rendent ces caractères invisibles. Voilà pourquoi un JSON collé depuis un traitement de texte échoue si souvent à la validation : le document semble propre à l’écran et contient des caractères dont la grammaire n’a jamais entendu parler.

L’espacement est aussi ce qui rend le formatage possible. Comme la grammaire ignore ces quatre caractères entre les tokens, un même document peut être une seule longue ligne en transit et un arbre indenté dans votre éditeur, et les deux formes sont sémantiquement identiques — aucun parseur ne peut les distinguer après lecture.

{"a":1,"b":[2,3]}

{
  "a": 1,
  "b": [
    2,
    3
  ]
}

Les chaînes : guillemets doubles et les neuf échappements

Une chaîne JSON est enveloppée de guillemets doubles — jamais de guillemets simples. À l’intérieur, la barre oblique inverse \ introduit un échappement, et la RFC 8259 définit exactement neuf échappements à deux caractères : deux sont obligatoires, \" pour un guillemet double littéral et \\\\ pour une barre oblique inverse littérale, car ces deux caractères termineraient ou corrompraient sinon la chaîne. Six autres sont des raccourcis optionnels — \/ pour la barre oblique et \b \f \n \r \t pour les cinq caractères de contrôle qui apparaissent le plus souvent dans le texte. La neuvième forme est \uXXXX, qui écrit n’importe quel point de code Unicode par son nombre hexadécimal à quatre chiffres.

Chaque caractère hors de l’ensemble d’échappement peut apparaître littéralement en UTF-8, et les deux formes sont équivalentes : un parseur délivre la chaîne identique dans les deux cas. L’échappement est une graphie, pas des données — un point que le guide de l’échappement développe en profondeur.

"quote": "she said \"hi\""
"path": "C:\\Users\\ada"
"e-acute": "\u00e9"

quote:   she said "hi"
path:    C:\Users\ada
e-acute: é

Les nombres : ECMAScript, sans les extensions

Un nombre est un entier ou un décimal en notation simple, avec un exposant optionnel. La RFC 8259 adopte la grammaire des nombres d’ECMAScript et en retire les extensions : pas d’hexadécimal, pas d’octal, pas de zéros initiaux, pas de plus initial, pas de point final isolé. Un exposant utilise e ou E avec un signe optionnel, et le seul signe par lequel un nombre peut commencer est le trait d’union simple. NaN, Infinity et -Infinity ne sont pas du JSON — les langages qui ont de telles constantes écrivent null à leur place, par convention.

La précision est délibérément laissée aux implémentations : la grammaire ne dit rien du nombre de chiffres qu’un parseur doit honorer, si bien que de très longs nombres peuvent arriver silencieusement modifiés. Les producteurs interopérables gardent les entiers dans la plage que la plateforme cible représente exactement — pour les doubles IEEE 754 derrière JavaScript, c’est jusqu’à 2^53 − 1.

Les trois littéraux et les cinq rejets classiques

Trois tokens nus complètent l’ensemble des valeurs : true, false et null. Ils sont en minuscules et sans guillemets — True, FALSE et None sont des erreurs de syntaxe, pas des majuscules créatives. Autour d’eux, la grammaire trace cinq lignes qui expliquent presque chaque document rejeté en conditions réelles :

• Pas de commentaires. La RFC 8259 n’a aucune syntaxe de commentaire ; // ou /* */ où que ce soit est une erreur de syntaxe. Annotez avec une clé voisine comme "_comment" quand le format est sous votre contrôle.
• Pas de virgules finales. [1, 2, 3,] et {"a":1,} sont invalides, si anodins qu’ils paraissent — la virgule est un séparateur, et elle ne peut pas séparer un élément de rien.
• Pas de guillemets simples et pas de clés sans guillemets. {name:'ada'} est un JSON invalide ; {"name":"ada"} est la seule graphie de la grammaire.
• Pas de clés dupliquées — officiellement. La grammaire autorise qu’un nom apparaisse deux fois, mais la RFC 8259 §4 laisse aux implémentations le choix de la valeur gagnante, si bien qu’un document qui repose sur des doublons n’a pas de sens défini.
• N’importe quelle valeur au premier niveau. Depuis la RFC 8259, un document entier peut être une chaîne nue, un nombre, un booléen ou null — la règle de la RFC 4627 restreignant aux objets et aux tableaux a disparu, et "hello" ou 42 sont des documents JSON complets.

L’encodage : UTF-8 et les règles au niveau de l’octet

La RFC 8259 §8.1 fixe l’encodage en octets : le texte JSON échangé entre systèmes qui ne font pas partie d’un écosystème fermé doit être encodé en UTF-8. Il n’existe pas de JSON UTF-16 ou UTF-32 sur le réseau ouvert, et les producteurs ne doivent pas préfixer une marque d’ordre des octets — un parseur peut ignorer un BOM en tête plutôt que de lever une erreur, mais rien de conforme n’en émet. Notez comme les couches se séparent : l’échappement \uXXXX est un choix de notation dans les chaînes individuelles, tandis que l’UTF-8 est une propriété du document entier, et les deux résolvent des problèmes différents.

Cela clôt la grammaire. Le moyen le plus rapide d’ancrer ces règles est de confronter vos propres documents à elles — formatez un vrai payload, enfreignez une règle à la fois, et lisez chaque erreur du validateur. Dix minutes d’échec délibéré enseignent plus qu’une lecture de plus de cette page.