JavaScript Object Notation

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	2001
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.

Imaginé par Douglas Crockford, le format JSON a été introduit pour la première fois sur la page json.org en 2001. Cette démarche a conduit à sa standardisation ultérieure sous la norme ECMA-404 d'Ecma International, dont la première édition a été publiée en octobre 2013. Une deuxième édition de la norme a été publiée en décembre 2017.

Il est également décrit par la RFC 8259 publiée en 2017 par l’Internet Engineering Task Force, qui remplace notamment les RFC 4627 et RFC 7159 et se veut compatible avec ECMA-404

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

Caractéristiques

Un texte en JSON peut contenir^,,  :

• deux types composés :
  • des objets, ou ensembles de paires « nom » (ou « clé ») / « valeur » ;
  • des listes ordonnées de valeurs (tableaux) ;
• quatre types scalaires :
  • des booléens, qui prennent la valeur true ou false ;
  • des nombres, écrits en notation décimale et pouvant comporter une partie fractionnaire ou un exposant. JSON n'admet ni les nombres inexistants (NaN) ni les valeurs infinies et ne distingue pas les entiers des nombres à virgule flottante ;
  • des chaînes de caractères, constituées d'une séquence de zéro ou plusieurs caractères Unicode et obligatoirement entourées de guillemets doubles ;
  • la valeur null, qui qualifie l'absence de valeur.

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

Exemple

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()

Commentaires

JSON est un format d'échange de données dont la syntaxe définie par la RFC n'admet pas les commentaires. Un analyseur syntaxique JSON strict détecte une erreur s'il rencontre un caractère ou une construction non prévu par la spécification.

Il existe des initiatives de formats étendant JSON pour ajouter des commentaires, comme Hjson, pour Human JSON en anglais, ou JSON5. Ces formats permettent de restituer du JSON standard, mais nécessitent un analyseur compatible avec leur syntaxe propre.

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, à 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. En 2012, il s'explique sur ce choix et reconnaît être conscient de la gêne que cette absence peut occasionner.

Usages

Bien qu’utilisant une notation issue de JavaScript, JSON est indépendant du langage de programmation. De nombreux langages de programmation disposent d'outils permettant de le lire ou de le produire. JSON sert à faire communiquer des applications dans un environnement hétérogène. Il est notamment utilisé comme format de transport de données avec AJAX et les services Web. D’autres solutions sont possibles, comme XML.

Le type de média MIME application/json est enregistré pour le transmettre notamment par le protocole HTTP.

Lorsqu'un texte JSON est échangé entre des systèmes qui ne font pas partie d'un même environnement fermé, la RFC 8259 impose l'utilisation de l'encodage UTF-8.

Un document JSON n'est pas nécessairement un tableau associatif : sa valeur de plus haut niveau peut être un objet, un tableau, une chaîne de caractères, un nombre, un booléen ou null.

Il peut aussi être utilisé pour :

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

La correspondance entre les valeurs JSON et les types natifs varie selon les langages de programmation. Par exemple, avec le module json de la bibliothèque standard de Python :

• les objets JSON correspondent notamment aux dictionnaires (dict) ;
• les tableaux JSON correspondent notamment aux listes (list) ;
• les chaînes de caractères JSON correspondent aux chaînes Python ;
• les booléens true et false correspondent respectivement à True et False ;
• la valeur null correspond à None.

Évaluation

En JavaScript, il est possible d'utiliser la fonction eval() pour interpréter certains textes JSON :

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

Cette méthode comporte toutefois des risques car la chaîne de caractères donnees_json peut contenir du code JavaScript exécutable. La RFC 8259 considère l'utilisation d'eval() pour analyser du JSON comme un risque de sécurité et recommande l'emploi d'un analyseur dédié.

À partir de 2009, les navigateurs commencent à intégrer un support natif du format JSON. Cela facilite sa manipulation et évite d'avoir recours à eval(). Ainsi les navigateurs Firefox 3.5, IE 8 ou encore Opera 10.5 l’intègrent en natif.

Analyser en JavaScript une chaîne JSON peut alors se faire avec JSON.parse() :

 var donnees = JSON.parse(donnees_json);

L'objet standard JSON, qui comprend notamment les méthodes JSON.parse() et JSON.stringify(), a été intégré à la cinquième édition de la norme ECMAScript, publiée en décembre 2009.

Différentes bibliothèques JavaScript ont également permis de prendre en charge les navigateurs plus anciens avec une syntaxe similaire.

Extensions du format

Annexes

Références

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