JavaScript Object Notation

Cet article ne cite pas suffisamment ses sources (novembre 2018).

Si vous disposez d'ouvrages ou d'articles de référence ou si vous connaissez des sites web de qualité traitant du thème abordé ici, merci de compléter l'article en donnant les références utiles à sa vérifiabilité et en les liant à la section « Notes et références ».

En pratique : Quelles sources sont attendues ? Comment ajouter mes sources ?

JSON
JavaScript Object Notation

logo du format JSON

Caractéristiques

Extension	.json
Type MIME	application/json
PUID	fmt/817
Développé par	Douglas Crockford
Version initiale	2002
Type de format	Texte
Basé sur	JavaScript
Norme	RFC 8259 et ECMA-404
Spécification	Format ouvert
Site web	json.org/json-fr.html

modifier - modifier le code - modifier Wikidata

JavaScript Object Notation (JSON) est un format de données textuel dérivé de la notation des objets du langage JavaScript. Il concurrence XML pour la représentation et la transmission d’information structurée^[1].

Créé par Douglas Crockford entre 2002 et 2005^[2], la première norme du JSON est ECMA-404^[3] d'Ecma International qui a été publiée en octobre 2003^[4]. Il est également décrit en 2017 par la RFC 8259^[5] de l’Internet Engineering Task Force qui se veut compatible avec Ecma-404 et ECMA-404.

Des bibliothèques pour le format JSON existent dans de nombreux langages de programmation^[6].

Un texte en JSON comprend^[7],[6] :

• deux types composés :
  • des objets JavaScript, ou ensembles de paires « nom » (ou « clé ») / « valeur ».
  • des listes ordonnées de valeurs (tableau) .
• quatre types scalaires :
  • des booléens : prend la valeur true ou false.
  • des nombres : un nombre décimal signé qui peut contenir une part fractionnable ou élevée à la puissance. Le JSON n'admet pas les nombres inexistants (NaN), et ne distingue pas les entiers et les flottants.
  • des chaînes de caractères : une séquence de 0 ou plus caractères Unicode. À l'instar des clés, elles sont obligatoirement entourées de guillemets.
  • la valeur null : qualifie l'absence de valeur.

Chacun de ces types peut être utilisé pour constituer un document.

Exemple de texte au format JSON :

{
    "menu": {
        "id": "file",
        "value": "File",
        "popup": {
            "menuitem": [
                { "value": "New", "onclick": "CreateNewDoc()" },
                { "value": "Open", "onclick": "OpenDoc()" },
                { "value": "Close", "onclick": "CloseDoc()" }
            ]
        }
    }
}

Équivalent au format XML :

 <menu id="file" value="File">
   <popup>
     <menuitem value="New" onclick="CreateNewDoc()"/>
     <menuitem value="Open" onclick="OpenDoc()"/>
     <menuitem value="Close" onclick="CloseDoc()"/>
   </popup>
 </menu>

Équivalent au format YAML :

menu:
    id: file
    value: File
    popup:
        menuitem:
           - value: New
             onclick: CreateNewDoc()
           - value: Open
             onclick: OpenDoc()
           - value: Close
             onclick: CloseDoc()

JSON est un format d'échange de données dont la RFC n'admet pas les commentaires, qui sont par nature des métadonnées. Un analyseur syntaxique JSON strict détecte une erreur s'il rencontre un caractère non prévu par la spécification.

Il existe des initiatives de formats étendant JSON pour ajouter des commentaires (comme Hjson^[8] pour Human JSON en anglais) et des logiciels permettant de restituer, à partir de ces formats dérivés, du JSON standard. Toutefois, ces fichiers, demandant alors une étape supplémentaire avant de pouvoir être lus par un interpréteur JSON standard, perdent légèrement en facilité d'interopérabilité.

On peut toujours ajouter une propriété à un champ dans un tableau associatif JSON, la nommer "_comment" (un usage qui se développe^{[Quand ?][réf. nécessaire]}), et mettre un texte (le commentaire) dans le champ valeur :

{
    "_comment": "Imported from Wikidata 2015-05-27 10:13.",
    "QID": "Q5502001",
    "label": "Adèle",
    "description": "late 18th century, early 19th century French brig"
}

Durant la mise au point du format, Douglas Crockford constate que certains des premiers utilisateurs du JSON ajoutent des commentaires dans le but de donner des directives au parseur^[9], à l'image des instructions #ifdef ou #define du préprocesseur C. Il y voit un danger pour l'interopérabilité, une priorité du format, et décide de les retirer^[9]. En 2012, il s'explique sur ce choix et reconnait être conscient de la tristesse des utilisateurs de ne pouvoir commenter ces fichiers^[9].

Bien qu’utilisant une notation JavaScript, JSON est indépendant du langage de programmation (plusieurs dizaines de langages de programmation ont intégré JSON). JSON sert à faire communiquer des applications dans un environnement hétérogène. Il est notamment utilisé comme langage de transport de données par AJAX et les services Web. D’autres solutions sont possibles comme XML. Le type MIME application/json est utilisé pour le transmettre par le protocole HTTP.

Un document JSON représente un tableau associatif, implémenté en JavaScript par la classe Object, d’où le nom de ce premier. Il est donc potentiellement plus facile à interpréter qu’un XML qui imposera le recours à des techniques souvent plus lourdes qu’un accès direct, telles que le parcours hiérarchique de l’arbre DOM représenté par le document entier.

Il peut aussi être utilisé pour :

• la sérialisation et dé-sérialisation de tableaux associatifs ;
• l’encodage de documents ;
• l'encodage de données structurées ;
• les fichiers de configuration.

La syntaxe utilisée par les modules disponibles dans différents langages de programmation peut varier. Par exemple, avec le module json de la bibliothèque standard de Python, il faudra adapter la syntaxe du langage Python qui diffère de celle utilisée par le format JSON :

• Pour les chaînes de caractères, seuls les guillemets doubles sont acceptés.
• Les booléens s'écrivent tout en minuscule (true et false).
• L'objet None est représenté par null

En JavaScript, il est simple d’évaluer une expression JSON pour la transformer en Object natif :

 var donnees = eval('('+donnees_json+')');

Cette méthode comporte toutefois des risques car la chaîne de caractères donnees_json peut contenir n’importe quel code JavaScript. Il existe une méthode plus sûre qui consiste à analyser la syntaxe de la chaîne de caractères donnees_json, seule solution disponible dans les autres langages de programmation, à l’exception de Python, la syntaxe de JSON correspondant à ses deux types principaux : les listes et les dictionnaires.

À partir de 2009, les navigateurs commencent à intégrer un support natif du format JSON. Cela facilite sa manipulation, la sécurité (contre l’évaluation de scripts malveillants inclus dans une chaîne JSON), et la rapidité de traitement. Ainsi les navigateurs Firefox 3.5, IE 8 ou encore Opera 10.5 l’intègrent en natif^[10].

Évaluer en JavaScript une expression JSON pour la transformer en Object se fait alors de la manière suivante :

 var donnees = JSON.parse(donnees_json);

Différentes bibliothèques javascript permettent de supporter des navigateurs plus anciens avec une syntaxe similaire.

JSONP ou JSON-P (pour JSON with padding, en français, « JSON avec formatage ») est une extension dans laquelle le nom de la fonction de retour est indiqué^[11]. L’idée originale proviendrait du blog de Bob Ippolito en 2005^[12] et est maintenant répandue dans les applications Web 2.0, telle que Google’s toolkit Applications^[13]. Des améliorations sont prévues pour y ajouter des arguments^[14].

JSONP utilise des balises de scripts, les appels sont ouverts. Ainsi, JSONP peut être inapproprié pour transporter des informations confidentielles.

JSON5 est une extension de la syntaxe du JSON, destiné à contourner les limitations de ce dernier.

• Les noms des champs ne sont plus entre guillemets
• Support des commentaires (sur une ou plusieurs lignes)
• Les nombres peuvent être représentés au format hexadécimal, être précédés du signe positif (+), avoir pour valeur Infinity ou NaN
• Espaces blancs supplémentaires autorisés
• Les chaînes de caractères peuvent être contenus entre apostrophes

HJSON est une extension de la syntaxe JSON, ayant le même objectif que JSON5 (voir ci-dessus).

• Les champs peuvent être séparés par un retour à la ligne au lieu d'une virgule
• Possibilité d'écrire des commentaires (#, //, /* ... */)
• L'utilisation des guillemets pour encapsuler une chaîne de caractères n'est pas obligatoire
• Les chaînes de caractères peuvent être écrites sur plusieurs lignes

• BSON (Binary JSON) : un format étendant les possibilités du JSON (données temporelles, binaires, etc.), notamment utilisé par MongoDB ;
• TopoJSON : un format de stockage des données topologiques ;
• GeoJSON : un format de stockage des données géographiques ;
• YAML : un autre langage de sérialisation de données.
• JSON-LD : (pour JavaScript Object Notation for Link Data) est un standard du W3C pour structurer des données sur le web en utilisant du JSON^[15],[16].

• (en) JSON5
• (en) HJSON

v · m Formats d'échange de données
Formats lisibles	Atom Syndication Format XML YAML JSON RDF Rebol RSS OWL
Formats binaires	AMF Ascii85 Base32 (en) Base 36 Base58 (en) Base64 BSON CBOR MessagePack

v · m JavaScript
Analyse statique de programmes	ESLint JSHint JSLint
Compilateur source à source	Babel.js CoffeeScript Dart Emscripten Google Closure Compiler Google Web Toolkit Morfik TypeScript AtScript Opa Nim Haxe Clojure WebSharper
Concepts	Ajax Client-side HTML dynamique Framework JavaScript Syntaxe JavaScript Javascript discret
Débogueur	Firebug Komodo IDE Microsoft Script Debugger Microsoft Script Editor Opera Dragonfly Venkman Web Inspector
Générateur de documentation	JSDoc
Éditeurs (comparaison (en))	Ace Cloud9 IDE Atom CodeMirror Light Table Brackets Koding Orion PhpStorm Visual Studio Visual Studio Express Visual Studio Code Visual Studio Team Services
Moteur	Moteur JavaScript
Framework	Comparaison des frameworks JavaScript
Technologie associée	Feuilles de style en cascade Document Object Model HTML JSON WebAssembly
Gestionnaire de paquets	npm NuGet Yarn
Côté serveur	Active Server Pages Bun CommonJS JSGI Node.js Deno Wakanda
Test unitaire	Jasmine Mocha QUnit
Personnalité	Douglas Crockford Brendan Eich John Resig

• Portail de l’informatique
• Portail de la programmation informatique